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INTRODUCTION 


This manual <iescribes the features of the UNIX system. It pro- 
vides neither a general overview of the UNIX system nor details 
of the implementation of the system. 

Not all commands, features, and facilities described* in this 
manual are available in every UNIX system. 

This manual is divided into two sections, some containing inter- 
filed sub-classes: 

? . System Calls 

3 . Subroutines : 

3C. C and Assembler Library Routines 
3S. Standard I/O Library Routines 
3M. Mathematical Library Routines 
3X. Miscellaneous Rouitnes 
M . File Formats 
5. Miscellaneous Facilities 
Section 2: System Calls 

This section describes the entries into the UNIX system kernel, 
including the C language interface. 

Section 3; Subroutines 

This section describes the available subroutines. Their binary 
versions reside in various system libraryies in the /lib and 
/usr/lib directories. See intro(3) for descriptions of these 
libraries and the files in which they are stored. 

Section 4: File Formats 

This section documents the structure of particular kinds of 
files; for example, the format of the outour file of the link 
editor is given in a.out(4). Excluded are files used by only one 
command (for example, the assembler's intermediate files). In 
general, the C language struct declarations corresponding to 



these formats car be found in the directories /usr/include and 
/usr / inc 1 ud e/ sy s . 

Section 5: Miscellaneous Facilities 

This section contains a variety of things. Included are descrip- 
tions of character sets, macro packages, etc. 

Each section consists of a number of independent entries of a 
page or so in length. The name of the entry appears in the upper 
corners of its page. Entries within each section are alphabet- 
ized, with the exception of an introductory entry that begins 
each section. Som.e entries may describe several routines, com- 
mands, etc. In such cases, the entry appears only once, alpha- 
betized under its "major" name. All entries are based on a com- 
mon format, not all of whose parts always appear in the following 
manner . 

The NAME part gives the name(s) of the entry and states briefly 
i t s p ur po se . 

The SYNOPSIS summarizes the use of the program being described. 
A few conventions are used, particularly in Section 1 (Commands): 

Boldface strings are literals and are to be typed just 
as the appear. 

Italic strings usually represent substitutable argument pro to - 
types and program names found elsewhere in the manual. (They are 
underlined in the typed version of the entries.) 

Square brackets [] around an argument prototype indi- 
cate that the argument is optional. When an argument 
prototype is given as "name" or "file," it always 
refers to a file name. 

Ellipses ... are used to show that the previous argu- 
ment prototype may be repeated. 

A final convention is used by the commands themselves. 
An argument beginning with a minus -, plus +, or equal 
sign = is often taken to be some sort of flag argument, 
even if it appears in a position where a file name 
could appear. Therefore, it is unwise to have files 
whose names begin with -, +, or =. 

The DESCRIPTION part discusses the subject at hand. 

The EXAMPLE(S) part gives example(s) or usage, where appropriate. 

The FILES part gives the file names that are built into the pro- 
gram. 

The SEE ALSO part gives pointers to related information. 



The DIAGNOSTICS part discusses the diagnostic indications that 
may be produced. Messages that are intended to be self- 
explanatory are not listed. 

The WARNINGS part points out potential pitfalls. 

The BUGS part gives known bugs and sometimes deficiences. Occa- 
sionally, the suggested fix is also described. 

A table of contents and a permuted index deriyed from that table 
precede Section 1 . On each index line, the title of the entry to 
which that line refers is followed by the appropriate section 
number in parentheses. This is important because there is con- 
siderable duplication of names among the sections, arising prin- 
cipally from commands that exist only to exercise a particular 
system call. 

On most systems, all entries are available on-line via the man(1) 
command (see Section 1 of the Enhanced Onyx System V User Refer- 
ence Manual ) . 



TABLE OF CONTENTS 


2 . Sy s t em Calls 


intro introduction to system calls and error numbers 

access ........determine accessibility of a file 

acct .....enable or disable process accounting 

alarm set a process's alarm clock 

brk change data segment space allocation 

chdir change working directory 

chmod ..change mode of file 

chown change owner and group of a file 

chroot change root directory 

close close a file descriptor 

creat create a new file or rewrite an existing one 

dup duplicate an open file descriptor 

exec execute a file 

exit terminate process 

fcntl file control 

fork ...create a new process 

getpid ...get process ID information 

getuid get user ID information 

ioctl control device 

kill terminate a process or a group of processes 

link link to a file 

Iseek .....move read/write file pointer 

mknod make a directory, or a special or ordinary file 

mount.... mount a file system 

msgctl message control operations 

msgget ...get message queue 

msgop ..message operations 

nice ....change priority of a process 

open open for reading or writing 

pause suspend process until signal 

pipe create an interprocess channel 

plock lock process, text, or data in memory 

profil ..execution time profile 

ptrace process trace 

read read from file 

semctl semaphore control operations 

semget get set of semaphores 

semop.. semaphore operations 

setpgrp set process group ID 

setuid set user and group IDs 

shmctl shared memory control operations 

shmget get shared memory segment 

shmop shared memory operations 

signal specify what to do upon receipt of a signal 

stat get file status 

stime set time 

sync update super-block 

t ime get t ime 

times ......get process and child process times 
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umask ...set and get file creation mask 

umount unmount a file system 

uname get name of current operating system 

unlink emo v e d i r e c t o r y entry 

ustat get file system statistics 

utime ...set file access and modification times 

wait wait for child process to stop or terminate 

write .......write on a file 


3. Subroutines 


intro introduction to subroutines and libraries 

a 6 4 1 . . , con ve r t between long integer and base-64 ASCII string 

abort .....generate an lOT fault 

abs. ..return integer absolute value 

acos return cosigne values 

asin... return sine of a number 

assert verify program assertion 

atan return tangent values 

atof convert ASCII string to floating-point number 

bessel Bessel functions 

bsearch .binary search 

clock .report CPU time used 

conv translate characters 

crypt..... ......................generate DES encryption 

ctermid .generate filename for terminal 

ctime ...convert date and time to string 

ctype..... classify characters 

cuserid ..get character login name of the user 

dial establish an out-going terminal line connection 

d r and 4 8 . ge ne r a t e uniformly distributed pseudo-random numbers 

ecvt..... ...convert floating-point number to string 

end last locations in program 

erf error function and complementary error function 

exp exponential, logarithm, power, square root functions 

fclose close or flush a stream 

ferror.... stream status inquiries 

f loo r . . . . f loo r , ceiling, remainder, absolute value functions 

fopen open a stream 

fread ...binary input/output 

frexp manipulate parts of floating-point numbers 

fseek reposition a file pointer in a stream 

ftw walk a file tree 

ftype .....explicit Fortran type conversion 

gamma ...log gamma function 

getarg return Fortran command-line argument 

getc get character or word from stream 

getcwd .......get pathname of current working directory 

getenv re turn value for environment name 

getenv return Fortran environment variable 

getgrent obtain 

get login ........ get login name 

getopt ....get option letter from argument vector 

ii 
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getpass read a password 

getpw... get name from UID 

getpwent get password file entry 

gets ...........get a string from a stream 

getut access utmp file entry 

hsearch manage hash search tables 

hypot Euclidean distance function 

index return location of Fortran substring 

13tol convert between 3-byte integers and long integers 

Idahread .read the archive header of an archive file 

Idclose ..close a common object file 

Idf bread ........ read the file header of a common object file 

Idgetname .....retrieve symbol name for object file 

Idlread alter line number entries for common object file 

1 d 1 s e ek . . . s e ek to line number entries for common object file 
Idohs eek . seek to optional file header for common object file 

Idopen open a common object file for reading 

Idr seek .... seek to relocation entries for common object file 
Idshr ead . . . . read named section header for common object file 

Idsseek seek to named section for common object file 

Idtbindex .. compute symbol table entry for common object file 

Idtbread read symbol table entry for common object file 

Idtbseek seek to symbol table of a common object file 

logname... return login name of user 

Isearch linear search and update 

malloc main memory allocator 

matherr error -handling function 

memory memory operations 

mktemp.... .•.•..••make a unique filename 

monitor prepare execution profile 

nlist get entries from name list 

perror system error messages 

plot graphics interface subroutines 

popen initiate pipe to/from a process 

printf print formatted output 

putc put character or word on a stream 

putpwent .....write password file entry 

puts put a string on a stream 

qsort quicker sort 

rand simple random-number generator 

r e g cmp .compile and execute a regular expression 

scanf convert formatted input 

setbuf .........assign buffering to a stream 

setjmp .non-local goto 

signal .. specif y Fortran action on receipt of a system signal 

sinh.... hyperbolic functions 

sleep........ suspend execution for interval 

spatiess long integer data in a machine independent fashion. 

ssignal... software signals 

stdio standard buffered input/output package 

stdipc standard interprocess communication package 

string.. ......string operations 


iii 
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s t r t o 1 . 
s wab . . . 
system, 
t e r me a p 
tmp f i 1 e 
t mpn am . 
trig. . . 
t search 
1 1 y name 
t ty slo t 
unge t c . 


convert string to integer 

.....swap bytes 

issue a shell command 

...terminal independent opera t ion routines 

create a temporary file 

create a name for a temporary file 

..trigonometric functions 

manage binary search trees 

.find name of a terminal 

...find the slot in the utmp file of the current user 
......push character back into input stream 


A. 


File Formats 

intro introduction to file formats 

a.out...... ..common assembler and link editor output 

acet per-process accounting file format 

aouthdr optional aout header 

ar ......common archive file format 

checklist.... ..list of file systems processed by fsck 

core.... format of core image file 

cpio format of cpio archive 

dir format of directories 

errfile error-log file format 

filehdr..... .......file header for common object files 

fs format of system volume 

fspec. format specification in text files 

gettydefs speed and terminal settings used by getty 

gps .... graphical primitive string, format of graphical files 

group... group file 

inittab .....script for the init process 

inode format of an inode 

issue ....issue identification file 

Idfcn ...common object file access routines 

linenum line number entries in a common object file 

master ..master device information table 

mnttab mounted file system table 

passwd password file 

plot graphics interface 

pnch file format for card images 

profile setting up an environment at login time 

reloc relocation information for a common object file 

senhdr. .....section header for a common object file 

syms .....common object file symbol table format 

utmp utmp and wtmp entry formats 


5. Miscellaneous Facilities 


intro introduction to miscellaneous facilities 

ascii .map of ASCII character set 

environ user environment 

eqnchar special character definitions for eqn and neqn 

fcntl file control options 

greek ..graphics for the extended TTY-37 type-box 

iv 
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man macros for formatting entries in this manual 

mm b.....the MM macro package for formatting documents 

mosd.the OSDD adapter macro package for formatting documents 

mptx the macro package for formatting a permuted index 

mv a troff macro package for typesetting 

regexp regular expression compile and match routines 

stat data returned by stat system call 

term conventional names for terminals 

termcap terminal capability data base 

types primitive system data types 



PERMUTED INDEX 

special functions of HP ? 6^0 anH ?6?1-series terminals /handle hp(1) 

/handle special functions of HP 2640 and 2621-series terminals hp(1) 

functions of DASI 3^0 and 3U0s/ 3^0, 3^0s: handle special 3'^U(1) 

handle special functions of DA5T 3^0 and 300s terminals /300s: 300(1) 

DAST 300 and 300s/ 300, 300s: handle special functions of . 300(1) 

special functions of DAST 300 and 300s terminals /300s: handle 300(1) 

13 tol, ltol3t convert between 3-byte integers and long/ 13 tol( 3 C) 

comparison diff3; 3'’way differential file diff3(i) 

4014 terminal 4014: paginator for the Tektronix , 4014(1) 

4014: paginator for the Tektronix 4014 terminal 4014(1) 

the DAST 450 terminal 450: handle special functions of 4'^0(1) 

special functions of the DAST 450 terminal 450: handle 450(1) 

onyx: Onyx 6810 special system service onyx (2 ) 

onyx: Onyx 6810 special system service onyx(2) 

integer and base-64 ASCII/ a641, 164a: convert between long a641(3C) 

abort: generate an lOT fault ...... abort(3C) 

value abs: return integer absolute ab3(3C) 

abs: return integer absolute value abs(3C) 

fabs: floor, ceiling, remainder, absolute value functions /fmod, ... floor(3M) 

LP requests, accept, reject: allow/ prevent accept(IM) 

utime: set file access and modification times utime(2) 

a file touch: update access and modification times of touch(l) 

of a file access: determine accessibility ... access(2) 

machine/ sputl, sgetl : access long integer data in a sputl(3X) 

sadp: disk access profiler sadpd) 

Idfcn: common object file access routines ldfcn(4) 

copy file systems for optimal access time, dcopy: dcopy(IM) 

/setutent, endutent, utmpname: access utmp file entry getut(3C) 

access: determine accessibility of a file access(2) 

acct: enable or disable process accounting acctC2) 

acctprcl, acctprc2: process accounting acctprc(IM) 

runacct: run daily accounting runacct(IM) 

acctconP: connect-time accounting, acctconi, acctcon(IM) 

/accton, acctwtmp: overview of accounting and miscellaneous/ acct(IM) 

accounting and miscellaneous accounting commands, /of acct(IM) 

acct: per-process accounting file format acct(4) 

acctcom: search and print process accounting file(s) acctcomCD 

acctmerg: merge or add total accounting files. acctmerg(IM) 

summary from per-process accounting records, /ccwimand ...... acctoms(IH) 

wtmpfix: manipulate connect accounting records, fwtmp, fvftmp(IM) 

turnacct: shell procedures for accounting, /startup, acctsh(IM) 

accounting acct: enable or disable process ... acct(2) 
format acct: per-process accounting file . acct(4) 

per-process accounting/ acctcms: command summary from acctcms(IM) 

accounting file(s) acctcom: search and print process . acctcom(l) 

connect-time accounting, acctconi, acctcon2: acctcon(IM) 

accounting, acctconi, acctcon2: connect-time acctcon(IM) 

acctwtmp: overview of/ acctdisk, acctdusg, accton, acct(IM) 

overview of/ acctdisk, acctdusg, accton, acctwtmp: acct(IM) 

accounting files. acctmerg; merge or add total acctmergClK 
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acctdisk, acctdusg, accton, acctwtmp: overview of/ .... acct(IM) 

accounting. acctprcl, acctprc?: process acctprc(iM) 

acctprcl, acctprc?: process accounting acctprc(IM) 

acctdisk, acctdusg, accton, acctwtmp: overview of/ acctCiM) 

functions sin, cos, tan, asin, acos, atan, atan?: trigonometric ,, trig(3M) 

killall: kill all active processes killalKiM) 

sag: system activity graph sag(1) 

sa1, sa?, sadc: system activity report package sar(IM) 

sar ; system activity reporter sar(1) 

report process data and system activity timex: time a command; ,,, timex(l) 

formatting/ mosd : the OSDD adapter macro package for mosd(5) 

adduser: add a user to the system adduserCiM) 

acctmerg: merge or add total accounting files acctmerg(IM) 

adduser: add a user to the system . adduser(IM) 

alarm: set a process's alarm clock alarm(?) 

clock alarm: set a process's alarm alarmC?) 

sbrk: change data segment space allocation brk, brk(?) 

realloc, calloc: main memory allocator raalloc, free, malloc(3C) 

accept, reject: allow/ prevent LP requests accept (IH) 

fsba: file system block analyzer fsba(IM) 

sort: sort and/or merge files sort(1) 

link editor output a. out: common assembler and a. out (4) 

aouthdr: optional aout header aouthdr(4) 

aouthdr: optional aout header aouthdr(4) 

introduction to commands and application programs intro: intro(l) 

maintenance commands and application programs, /system intro(IM) 

raaintainer for portable/ ar : archive and library ar(1) 

ar : common archive file format .... ar(4) 
language be: . arbitrary-precision arithmetic .... bed) 

cpio: format of cpio archive cpio(4) 

for portable archives ar : archive and library maintainer .... ar(1) 

ar : common archive file format ar(4) 

archive header of a member of an archive file Idahread: read the ... ldahread(3X) 

archive file Idahread: read the archive header of a member of an .. ldahread(3X) 

tar: tape file archiver tarCl) 

library maintainer for portable archives ar : archive and ar(1) 

cpio: copy file archives in and out cpiod) 

command xargs: construct argument list(s) and execute xargsCl ) 

getopt: get option letter from argument vector getopt(3C) 

echo: echo arguments echoCl ) 

expr: evaluate arguments as an expression exprCl) 

be: arbitrary-precision arithmetic language bed) 

number facts arithmetic; provide drill in ar ithmetic(6 ) 

expr: evaluate arguments as an expression exprCl) 

as- common assembler asCl) 

asa : interpret ASA carriage control characters ... asaCl) 

control characters asa: interpret ASA carriage asaCl) 

ascii: map of ASCII character set ascii(5) 

set ascii; map of ASCII character ascii(5) 

between long integer and base-64 ASCII string /164a: convert a641(3C) 

number atof: convert ASCII string to floating-point .... atof(3C) 

time/ ctime, localtime, gmtime, asetime, tzset: convert date and ctime(3C) 
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trigonometric/ sin, cos, tan, asin, acos, atan, atan?: trig(3M) 

help: ask for help help(l) 

as- common assembler as(1) 

a. out: common assembler and link editor output a.out(M) 

assert: verify program assertion assert(3X) 

assert: verify program assertion assert(3X) 

setbuf: assign buffering to a stream setbuf(3^^) 

/list the spared sectors associated with a slice sparelistCS) 

sin, cos, tan, asin, acos, atan, atan2: trigonometric/ trig(3M) 

sin, cos, tan, asin, acos, atan, atan?; trigonometric functions .... trig(3M) 

floating-point number atof: convert ASCII string to atof(3C) 

strtol, atol , atoi: convert string to integer ... strtoKSC) 

integer strtol, atol, atoi: convert string to strtol(3C) 

wait: await completion of process wait(l) 

processing language awk: pattern scanning and awk(1) 

ungetc: push character back into input stream ungetc(3S) 

back: the game of backgammon ...... back(6) 

back: the game of backgammon back(6) 

fine: fast incremental backup, finc(IM) 

daily/weekly UNIX file system backup, filesave, tapesave: filesave(IM) 

free: recover files from a backup tape frec(IM) 

spare: replace a bad sector with a spare one spare(8) 

banner: make posters banner(l) 

termcap: terminal capability data base termcap(5) 

convert between long integer and base-64 ASCII string /164a: a641(3C) 

oriented (visual) display editor based on ex vi: screen vi(1) 

portions of pathnames basename, dirname: deliver basename(l) 

arithmetic language be; arbitrary-precision bed) 

system initialization/ bre , bcheckrc, rc , powerfail: brcClM) 

bcopy: interactive block copy bcopyCiM) 

files bdiff: file comparator for large bdiff(l) 

cb : C program beautifier cb(1) 

j'lf yO, y1, yn: Bessel functions bessel(3M) 

bfs: big file scanner bfs(1) 

fread, fwrite: binary input/output fread(3S) 

bsearch: binary search bsearch(3C) 

tsearch, tdelete, twalk: manage binary search trees tsearch(3C) 

b j : the game of black jack bj(6) 

b j : the game of black jack bj(6) 

sync: update the super block sync(l) 

fsba: file system block analyzer. fsbaClM) 

bcopy: interactive block copy bcopyClM) 

sum: print checksum and block count of a file sumCl) 

df: report number of free disk blocks. df(1M) 

system initialization shell/ bre, bcheckrc, rc , powerfail: brcClM) 

space allocation brk, sbrk: change data segment brk(?) 

modest-sized programs bs; a compiler/interpreter for .... bsCl) 

bsearch: binary search bsearch(3G) 

stdio: standard buffered input/output package stdio(3S) 

setbuf: assign buffering to a stream setbuf(3^^) 

mknod : build special file. mknodClM) 

swab: swap bytes 3wab(3C) 
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cc- C compiler ccCi) 

cflow: generate C flow graph cflow(l) 

cpp: the C language preprocessor ........... cpp(1) 

cb : C program beautifier cbCl) 

lint: a C program checker lint(l) 

cxref: generate C program cross-reference ......... cxrefd) 

cal: print calendar cal(1) 

dc: desk calculator dc(1) 

cal: print calendar cal(1) 

calendar: reminder service calendar(l) 

cu: call another UNIX SYSTEM V system . cu(1C) 

data returned by stat system call stat; stat(5) 

malloc, free, realloc, calloc: main memory allocator mallocCSC) 

intro: introduction to system calls and error numbers intro(2) 

link and unlink system calls, link, unlink: exercise link(IM) 

an LP line printer Ip, cancel; send/cancel requests to ... lp(1) 

termcap: terminal capability data base termcap(5) 

asa: interpret ASA carriage control characters asa(1) 

text editor (variant of ex for casual users) edit: edit(1) 

cat; concatenate and print files ,. cat(1) 
cat; phototypesetter interface .... cat(7) 

cb: C program beautifier cb(1) 

cc- C compiler cc(1) 

cd; change working directory cd(1) 

remainder, absolute value/ floor, ceil, fmod , fabs; floor, ceiling, . floor(3M) 

floor, ceil, fmod, fabs: floor, ceiling, remainder, absolute/ floor(3M) 

cflow; generate C flow graph cflowd) 

pipe: create an interprocess channel pipeC2) 

ungetc: push character back into input stream .. ungetc(3S) 

neqn eqnchar ; special character definitions for eqn and , eqnchar(5) 

cuserid: get character login name of the user .. cuserid(3S) 

getc , getchar, fgetc, getw; get character or word from stream getc(3S) 

putc, putchar , fputc, putw: put character or word on a stream putc(3S) 

ascii: map of ASCII character set ascii(5) 

tr : translate characters trd) 

interpret ASA carriage control characters asa: asad) 

iscntrl, isascii; classify characters /isprint, isgraph, ..... ctype(3C) 

_tolower , toascii: translate characters /tolower, ^toupper, .... conv(3C) 

lastlogin, raonacct, nulladm,/ chargefee, ckpacct, dodisk, acctshClM) 

chdir; change working directory ... chdirC?) 

/dfsck; file system consistency check and interactive repair fsckClM) 

checking procedure. checkall; faster file system checkalKlM) 

text for troff cw, checkcw; prepare constant-width ... cwCl ) 

for nroff or troff eqn, neqn, checkeq: format mathematical text . eqnCl) 

lint; a C program checker lintd) 

grpck; password/group file checkers, pwck, pwckClM) 

checkall: faster file system checking procedure checkalldM) 

copy file systems with label checking, volcopy, labelit; volcopyClM) 

copy file systems with label checking, volcopy, labelit; volcopy . 1m. old 

processed by fsck checklist; list of file systems ... checklist(M) 
formatted with the MM/ mm, osdd, checkmm; print/ check documents .... mmCl) 

file sura: print checksum and block count of a sumCl) 
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chess: the game of chess chess(6) 

chess: the game of chess chess(6) 

chown, chgrp: change owner or group chown(l) 

tiroes: get process and child process times tiroes(2) 

terminate wait: wait. for child process to stop or wait(2) 

chjnod : change mode chmod(l) 

chmod : change mode of file chjnod(2) 

a file chown: change owner and group of .. chown(2) 

group chown, chgrp: change owner or chown(l) 

for a command. chroot: change root directory chroot(IM) 

chroot: change root directory chroot(2) 

monacct, nulladm,/ chargefee, ckpacct, dodisk, lastlogin, acctshClM) 

isgraph, iscntrl, isascii: classify characters /isprint, ctype(3C) 

uuclean: uucp spool directory clean-up uuclean(IM) 

clri; clear i-node clri(IK) 

inquiries ferror, feof, clearerr, fileno: stream status ... ferrorOS) 

alarm; set a process’s alarm clock alarm(2) 

cron: clock daemon cron(lM) 

clock: report CPU time used clock(3C) 

Idclose, Idaclose: close a common object file ldclose(3X) 

close; close a file descriptor close(2) 

close: close a file descriptor close(2) 

fclose, fflush; close or flush a stream fclose(3S) 

clri: clear i-node clri(IM) 

cmp: compare two files cmp(1) 

/idint, real, float, sngl, dble, cmplx, dcmplx, ichar, char:/ ftype(3F) 

col: filter reverse line- feeds .... cold) 
common to two sorted files comm: select or reject lines ...... comm(l) 

system: issue a shell command system (3S) 

test: condition evaluation command testd ) 

time: time a command timed) 

nice; run a command at low priority nlced) 

change root directory for a command, chroot: chrootClM) 

env : set environment for command execution envCl) 

uux : Unix to unix canmand execution uuxClC) 

quits nohup: run a command immune to hangups and nohupCl) 

getopt: parse command options getoptCl) 

/shell, the standard/restricted command programming language shd) 

system activity timex : time a command; report process data and ,. timexCl) 

per-process/ acctcms: command summary from acctcmsClM) 

argument list(s) and execute command xargs: construct xargsCl) 

install; install commands instalKlM) 

mk: how to remake the system and commands rak(8) 

programs intro: introduction to commands and application introd) 

/to system maintenance commands and application/ introClM) 

and miscellaneous accounting commands, /of accounting acctClM) 

ar: common archive file format ar(4) 

as- common assembler asCl) 

output a. out: common assembler and link editor .. a.out(4) 

Idclose, Idaclose: close a common object file ldclose(3X) 

/section header of a common object file ldshread(3X) 

linenum: line number entries in a common object file linenum(4) 
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niTj : print name list of common object file nm(1) 

scnhdr: section header for a common object file scnhdr(M) 

routines Idfcn: common object file access IdfcnC^) 

Idopen, Idaopen: open a common object file for reading .... ldopen(3X) 

/line number entries of a common object file function ldlreadC3X) 

read the file header of a common object file Idfhread: ldfhread(3X) 

seek to the symbol table of a common object file Idtbseek: ldtbseek(3X) 

indexed symbol table entry of a common object file /read an ldtbread(3X) 

relocation information for a common object file reloc: relcc(M) 

entries of a section of a common object file /relocation .... ldrseek(3X) 

to the optional file header of a common object file /seek ldohseek(3X) 

to an indexed/named section of a common object file /seek ldsseek(3X) 

number entries of a section of a common object file /seek to line ., ldlseek(3X) 

format syms; common object file symbol table ... syms(M) 

of a symbol table entry of a common object file /the index ldtbindex( 3X ) 

filehdr: file header for common object files filehdrCM) 

Id: link editor for common object files ld(l) 

size: print section sizes of common object files sizeCi) 

comm: select or reject lines common to two sorted files comm(l) 

ipcs: report inter-r-process communication facilities status ... ipcs(1) 

stdipc: standard interprocess communication package stdipc(3C) 

diff: differential file comparator diff(1) 

bdiff; file comparator for large files bdiff(l) 

cmp: compare two files cmp(1) 

diff3: 3-way differential file comparison diff3(1) 

dircmp: directory comparison dircrap(l) 

regcmp: regular expression compile regcmpCl ) 

expression regcmp, regex; compile and execute a regular regcmp(3X) 

regexp; regular expression compile and match routines regexp(5) 

cc- C compiler cc(1) 

yacc : yet another compiler-compiler yacc(1) 

modest-sized programs bs: a compiler/interpreter for bsCI) 

erf, erfc; error function and complementary error function erf(3M) 

wait: await completion of process wait(1) 

pack, peat, unpack: compress and expand files pack(1) 

table entry of a/ Idtbindex: compute the index of a symbol ldtbindex(3X) 

cat: concatenate and print files cat(l) 

synchronous printer scat: concatenate and print files on scat(1) 

test: condition evaluation command test(l) 

config; configure UNIX SYSTEM V, .. config .68( 1M) 

system. Ipadmin; configure the LP spooling IpadmindM) 

config: configure UNIX SYSTEM V config .68( IM) 

fwtrap, wtmpfix; manipulate connect accounting records fwtmpdM) 

an out-going terminal line connection dial: establish dial(3C) 

acctconi, acctconP: connect-time accounting. acctcon(IM) 

fsck, dfsck: file system consistency check and/ fsck(IM) 

report and interactive status console rjestat: FJE status rjestat(IC) 

cw, cheokew: prepare constant-width text for troff cw(1) 

mkfs: construct a file system mkfsOM) 

execute command xargs: construct argument list(s) and .... xargs(l) 

remove nroff/troff, tbl , and eqn constructs deroff: deroffCD 

Is; list contents of directories ls(1) 
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csplit: context split cspllt(l) 

fcntl : file control fcntK?) 

vc: version control vc(1) 

asa : interpret ASA carriage control characters asa(1) 

ioctl: control device ioctK?) 

init, telinit: process control initialization init(IM) 

msgctl: message control operations msgctK?) 

semctl: semaphore control operations semctKP) 

shmctl : shared memory control operations shmctKP) 

fcntl: file control options fcntl(5) 

UUCP status inquiry and job control uustat: uustat(IC) 

tty: controlling terminal interface tty(7) 

term: conventional names for terminals ,, term(5) 

units; conversion program units(l) 

dd : convert and copy a file dd(1) 

floating-point number atof: convert ASCII string to atof(3C) 

and long integers 13tol, ltol3: convert between 3''t'yte integers ... 13tol(3C) 

base-64 ASCII/ a641, 164a: convert between long integer and .. a641(3C) 

/gmtime, asctime, tzset; convert date and time to string ... ctime(3C) 

and VAX-1 1/780/ fscv : convert files between M68000 fscv(IM) 

string ecvt, fcvt, gcvt: convert floating-point number to .. ecvt(3C) 

scanf, fscanf, sscanf: convert formatted input scanf(3S) 

strtol, atol, atoi: convert string to integer strtol(3C) 

bcopy: interactive block copy bcopy(IM) 

uucp, uulog, uuname: unix to unix copy uucpCiC) 

dd ; convert and copy a file dd(1) 

cpio: copy file archives in and out cpio(l) 

access time, dcopy: copy file systems for optimal dcopy(IM) 

checking, volcopy, labelit: copy file systems with label volcopy(IM) 

checking, volcopy. labelit: copy file systems with label volcopy . 1m. old 

cp, In, mv: copy, link or move files cp(1) 

UNIX System-to-UNIX System file copy uuto, uupick; public uuto(IC) 

core: format of core image file ... core(4) 

core: format of core image file core(4) 

mem, kmem: core memory meffl(7) 

atan2: trigonometric/ sin, cos, tan, asin, acos, atan, trig(3M) 

sinh, cosh, tanh: hyperbolic functions .. sinh(3M) 

wc ; word count wc ( 1 ) 

sum: print checksum and block count of a file sumCD 

files cp. In, mv: copy, link or move ,,,. cp(1) 

cpio: format of cpio archive cpio(4) 

out cpio: copy file archives in and ... cpio(l) 

cpio: format of cpio archive cplo(4) 

cpp: the C language preprocessor ., cpp(1) 

clock: report CPU time used clock(3C) 

craps: the game of craps craps(6) 

craps: the game of craps craps(6) 

crash: examine system images crash(IM) 

crashes crash: what to do when the system . crash.m68(8) 

crash: what to do when the system crashes crash,m68(8) 

rewrite an existing one creat: create a new file or creat(2) 

file tmpnam, tempnam: create a name for a temporary tmpnam(3S) 
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existing one creat: create a new file or rewrite an ... creat(2) 

fork: create a new process fork(2) 

tmpfile; create a temporary file tmpfileO?) 

pipe: create an interprocess channel .... pipe(2) 

umask: set anri get file creation mask uraaskC?) 

cron: clock <iaemon cron(IM) 

cxref: generate C program cross-reference cxrefd) 

DES encryption crypt, setkey, encrypt: generate .. crypt(3C) 

csplit: context split csplit(l) 

terminal ct: spawn getty to a remote ct(1C) 

terminal ctermi^ : generate filename for .... ctermirt(3S) 

asctime, tzset: convert 'iate and/ ctime, localtime, gmtime, ctimeC3C)) 

cu: call another UNIX SYSTEM V system cu(1C) 

ttt , cubic: tic-tac-toe ttt(6) 

uname: get name of current operating system unameC?) 

unam'^: print name of current UNIX System uname(T) 

the slot in the utmp file of the current user ttyslot: find ttyslct(3C) 

getcwd : get pathname of current working directory getcwd(3C) 

of the user cuserid: get character login name . cuserid(3S) 

each line of a file cut: cut out selected fields of ... cut(1) 

line of a file cut: cut out selected fields of each ... cut(1) 

constant-width text for troff cw, checkcw: prepare cw( 1 ) 

cross-reference cxref: generate C program cxref(l) 

cron: clock daemon cron(IM) 

errdemon: error-logging daemon. errdemonCiM) 

Ipd: line printer daemon Ipd(IC) 

terminate the error-logging daemon, errstop: errstop(IM) 

runacct: run daily accounting. runacct(IM) 

backup, filesave, tapesave: daily/weekly UNIX file system filesaveCiM) 

/300s: handle special functions of DASI 3U0 and 3OOS terminals 300(1) 

handle special functions of the DASI 450 terminal 450: 450(1) 

prof: display profile data prof(1) 

time a command; report process data and system activity tiraex: ... timex(l) 

termcap: terminal capability data base termcap(5) 

sputl, sgetl: access long integer data in a machine independent/ sputl(3X) 

plock: lock process, text, or data in memory plock(2) 

call stat; data returned by stat system stat(5) 

brk, sbrk: change data segment space allocation brk(2) 

types: primitive system data types types(5) 

join: relational database operator join(1) 

date: print and set the date dated) 

date: print and set the date date. 1, old 

/gmtime, asctime, tzset: convert date and time to string ctime(3C) 

date: print and set the date dated) 

date; print and set the date d ate. 1, old 

/ifix, idint, real, float, sngl, dble, cmplx , dcmplx, ichar , char:/ ftype(3F) 

dc; desk calculator dc(1 ) 

/real, float, sngl, dble, cmplx, dcmplx, ichar, char: explicit/ .... ftype(3F) 

optimal access time. dcopy: copy file systems for dcopydM) 

dd : convert and copy a file ddd) 

fsdb, fsdbib: file system debugger fsdbdM) 

sdb: symbolic debugger sdbd) 
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sysdef; system definition sysdef(IM) 

eqnchar; special character definitions for eqn and neqn eqncharCS) 

basename, dirname: deliver portions of pathnames basename(l) 

tail: deliver the last part of a file ... tail(l) 

mesg: permit or deny messages roesg(l) 

and eqn constructs deroff: remove nroff/troff, tbl, deroff(l) 

crypt, setkey, encrypt: generate DES encryption crypt(3C) 

close: close a file descriptor close(?) 

dup: duplicate an open file descriptor dup(2) 

dc: desk calculator dc(1) 

file access; determine accessibility of a access(2) 

file: determine file type file(1) 

ioctl: control device ioctl(P) 

master; master device information table master .dec ( ^ ) 

devnm; device name devnm(IM) 

devnm; device name devnm(IM) 

blocks. df; report number of free disk .... df(1M) 
check and interactive/ fsck, dfsck: file system consistency .... fsck(IM) 

terminal line connection dial: establish an out-r-going ...... dial(3C) 

comparator diff: differential file diff(1) 

comparison diff3: 3-way differential file .... diff3(1) 

sdiff: side-by-side difference program sdiff(l) 

diffmk: mark differences between files diffrak(l) 

diff; differential file comparator diff(l) 

diff3; 3-way differential file comparison diff3(1) 

files diffmk; mark differences between .. diffmk(l) 

dir: format of directories dir(4) 

dircmp; directory comparison dircmp(l) 

dir; format of directories dlr(^) 

Is; list contents of directories ls(1) 

rm, rmdir; remove files or directories rm(1) 

cd : change working directory cd(1) 

chdir: change working directory chdir(2) 

chroot: change root directory chroot(2) 

mkdir; make a directory mkdir(l) 

mvdir; move a directory mvdir(IM) 

uuclean: uucp spool directory clean-up uuclean(IM) 

dircmp: directory comparison dircmp(l) 

unlink; remove directory entry unlinkC?) 

chroot: change root directory for a command chroot(IM) 

get pathname of current working directory getcwd ; getcwd(3C) 

pwd ; working directory name pwd(1) 

ordinary file mknod ; make a directory, or a special or mknod(2) 

pathnames basename, dirname: deliver portions of basename(l) 

printers enable, disable; enable/disable LP enabled ) 

acct: enable or disable process accounting acct(2) 

type, modes, speed, and line discipline, /set terminal getty(IM) 

sadp: disk access profiler sadpCl) 

df; report number of free disk blocks df(1M) 

du: summarize disk usage du(1) 

mount, umount: mount and dismount file system mountClM) 

vi: screen oriented (visual) display editor based on ex vi(1) 
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prof: display profile data profCl) 

hypot: Euclidean distance function hypot(3M) 

/lcong48: generate uniformly distributed pseudo-random/ drandM8(3C) 

mm, osdd, checkmm; print/ check documents formatted with the MM/ mm(1) 

MM macro package for formatting documents mm: the mm(5) 

macro package for formatting documents /the OSDD adapter mosd(5) 

slides mmt , mvt: typeset documents, viewgraphs, and mmt(1) 

nulladm,/ chargefee, ckpacct, dodisk, lastlogin, monacct, acctsh(IM) 

whodo: who is doing what, whodo(IM) 

reversi: a game of dramatic reversals reversi(6) 

nrand48, mrand48, jrandMS,/ drand48, erandUS, IrandUB, drand4S(3C) 

arithjnetic: provide drill in number facts arithjnetic(6; 

trace: event-tracing driver traceCT) 

du: summarize disk usage du(1) 

od : octal dump od(l) 

object file dump: dump selected parts of an ... dump(l) 

extract error records from dump, errdead: errdead(lM) 

file dump: dump selected parts of an object .. dump(l) 

descriptor dup: duplicate an open file dupC2) 

descriptor dup: duplicate an open file dup(2) 

echo: echo arguments echo(l) 

echo: echo arguments echo(l) 

floating-point number to string ecvt, fcvt, gcvt: convert ecvt(3C) 

ed , red: text editor ed(1) 

end, etext, edata: last locations in program .. end(3C) 

for casual users) edit: text editor (variant of ex .. edit(l) 

ed , red: text editor ed(1) 

ex: text editor ex(1) 

sed ; stream editor sed(1) 

screen oriented (visual) display editor based on ex vi; vi(1) 

Id: link editor for common object files ld(l) 

common assembler and link editor output a, out; a.out(4) 

users) edit: text editor (variant of ex for casual ., edit(1) 

effective user, real group, and effective group IDs /real user, ... getuid(2) 

/getgid, getegid: get real user, effective user, real group, and/ ,, getuid(2) 

fsplit: split f77, ratfor, or efl files fsplitd) 

pattern grep, egrep, fgrep: search a file for a . grep(1) 

LP printers enable, disable: enable/disable ... enabled) 

accounting acct: enable or disable process acct(2) 

enable, disable: enable/disable LP printers enabled) 

crypt, setkey, encrypt; generate DES encryption .. crypt(3C) 

setkey, encrypt: generate DES encryption crypt, crypt(3C) 

makekey; generate encryption key makekeyd ) 

in program end, etext, edata: last locations . end(3C) 

getgrgid, getgrnam, setgrent, endgrent; obtain getgrent, getgrent(3C) 

/getpwuid, getpwnam, setpwent, endpwent; get password file/ getpwent(3C) 

/getutline, pututline, setutent, endutent, utmpname; access utmp/ ., getut(3C) 

nlist: get entries from name list nlist(3C) 

linenum: line number entries in a common object file ... linenum(4) 

man, raanprog: print entries in this manual manCD 

man: macros for formatting entries in this manual man(5) 

/Idlitem: manipulate line number entries of a common object file/ ,, ldlread(3X) 
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/Idnlseek: seek to line number entries of a section of a common/ , ldlseek(3X) 

/Idnrseek: seek to relocation entries of a section of a common/ . ldrseek(3X) 

putpwent; vfrite password file entry putpwent(3C) 

unlink: remove directory entry unlink(?) 

utrap, wtmp; utmp and wtmp entry formats utmp(i|) 

endpwent: get password file entry /getpwnam, setpwent, getpwent(3C) 

/the index of a symbol table entry of a common object file ldtbindex(3X 

/read an indexed symbol table entry of a common object file ..... Id thread ( 3 X ) 

utmpname; access utmp file entry /setutent, endutent, getut(3C) 

execution env : set environment for command .. env(1) 

environ: user environment environ(5) 

environ: user environment envlron(5) 

profile: setting up an environment at login time profile(^) 

execution env: set environment for command env(l) 

getenv: return value for environment name getenv(3C) 

sky: obtain ephemerides sky(6) 

special character definitions for eqn and neqn eqnchar : eqnchar(5) 

remove nroff/troff, tbl , and eqn constructs deroff: deroff(l) 

mathematical text for nroff or/ eqn, neqn, checkeq: format eqn(1) 

definitions for eqn and neqn eqnchar: special character eqnchar(5) 

mrand48, jrand48,^ drandi48, erandi|8, lrand48, nrand48, drand48(3C) 

complementary error function erf, erfc: error function and erf(3M) 

complementary error/ erf, erfc: error function and erf(3M) 

err: error-logging interface err(7) 

from dump. errdead; extract error records .... errdead(lM) 

, daemon. errdemon: error-logging errdemon( 1M'‘ 

errfile: error-log file format .... errfile(4) 

system error messages perror, err no, sys^errlist, sys^nerr: perror(3C) 

error function erf, erfc: error function and complementary .. erf(3M) 

error function and complementary error function erf, erfc: erf(3M) 

sys_errlist, sys__nerr: system error messages perror, errno, perror(3C) 

introduction to system calls and error numbers intro: intro(2) 

errdead: extract error records from dimp errdead(IM) 

raatherr: error-handling function matherr(3M) 

errfile: error-log file format errfile(4) 

errdemon: error-logging daemon errdemonClM) 

errstop: terminate the error-logging daemon errstop(IM) 

err: error-logging interface err(7) 

process a report of logged errors, errpt: errpt(IM) 

spellin, hashcheck: find spelling errors spell, hashmake, spell(l) 

logged errors. errpt: process a report of errpt(IM) 

error-logging daemon. errstop; terminate the errstop(IM) 

line connection dial: establish an out-going terminal ... dial(3C) 

setmnt: establish mount table setmnt(IM) 

program end, etext, edata: last locations in ... end(3C) 

hypot: Euclidean distance function hypot(3M) 

expression expr: evaluate arguments as an expr(1) 

test: condition evaluation command test(1) 

trace: event-tracing driver trace(7) 

edit: text editor (variant of ex for casual users) edit(l) 

ex; text editor ex(1) 

(visual) display editor based on ex vi: screen oriented vi(1) 
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crash: examine system images crash(IM) 

execlp, execvp: execute a file execl, execv, execle, execve, exec(?) 

execute a file execl, execv, execle, execve, execlp, execvp: ... execC?) 

execl, execv, execle, execve, execlp, execvp: execute a file exec(?) 

execle, execve, execlp, execvp: execute a file execl, execv, exec(?) 

regcmp, regex: compile and execute a regular expression regcmpOX) 

construct argument list(s) and execute command xargs: xargs(l) 

env ; set environment for command execution env(1) 

uux : Unix to unix command execution uux(IC) 

sleep; suspend execution for an interval sleep(l) 

sleep: suspend execution for interval sleepOC) 

monitor: prepare execution profile monitor(3C) 

profil: execution time profile profilC?) 

execvp: execute a file execl, execv, execle, execve, execlp, .... exec(?) 

file execl, execv, execle, execve, execlp, execvp: execute a . exec(?) 

execv, execle, execve, execlp, execvp: execute a file execl, exec(2) 

system calls, link, unlink: exercise link and unlink link(iM) 

create a new file or rewrite an existing one creat: creat(?) 

exit, exit: terminate process .... exit(2) 

exit, __exit: terminate process exitC?) 

exponential, logarithm, power,/ exp, log, loglO, pow, sqrt: expCSM) 

pack, peat, unpack: compress and expand files pack(l) 

exp, log, loglO, pow, sqrt: exponential, logarithm, power,/ ... exp(3M) 

expression expr: evaluate arguments as an .... expr(l) 

expr: evaluate arguments as an expression expr(1) 

regcmp: regular expression compile regcmpCl) 

routines regexp; regular expression compile and match regexp(5) 

compile and execute a regular expression regcmp, regex: regcmpC3X) 

greek: graphics for the extended TTY«-37 type«*box greek(5) 

dump, errdead : extract error records from errdeadCiM) 

fsplit: split f77, ratfor, or efl files fsplit(l) 

absolute/ floor, ceil, fmod , fabs: floor, ceiling, remainder, ,. floor(3M) 

factor: factor a number factor(l) 

factor: factor a number factor(l) 

true, false: provide truth values ....... true(l) 

data in a machine independent fashion, /access long integer sputl(3X) 

fine; fast incremental backup fincdM) 

procedure, checkall: faster file system checking checkalKiM) 

abort: generate an lOT fault abort(3C) 

stream fclose, fflush; close or flush a .. fclose(3S) 

fcntl: file control fcntl(2) 

fcntl; file control options fcntl (5) 

floating-point number to/ ecvt, fevt, gevt; convert ecvt(3C) 

fopen, freopen, fdopen: open a strean fopen(3S) 

status inquiries ferror, feof, clearerr, fileno: stream .... ferror(3S) 

stream status inquiries ferror, feof, clearerr, fileno: ,,, ferror(3S) 

statistics for a file system. ff: list file names and ffCiM) 

fclose, fflush; close or flush a stream ... fclose(3S) 

word from stream getc, getchar, fgetc, getw: get character or getc(3S) 

stream gets, fgets: get a string from a gets(3S) 

pattern grep, egrep, fgrep: search a file for a grep(1) 

chmod: change mode of file chmodC2) 
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core: format of core image file core(M) 

dd : convert and copy a file dd(1) 

group: group file group(^) 

issue: issue identification file issue(y) 

link: link to a file link(2) 

raknod : build special file mknod(1M) 

null: the null file null(7) 

passwd : password file passwdCM) 

read: read from file read(?) 

tail; deliver the last part of a file tail(l) 

tmpfile: create a temporary file tmpfile(3S) 

uniq: report repeated lines in a file uniq(1) 

write: write on a file write(?) 

determine accessibility of a file access: access(2) 

times utime: set file access and modification ...... utime(2) 

Id fen: common object file access routines Idfcn(^) 

tar: tape file archiver tar(1) 

cpio: copy file archives in and out cpiod) 

pwck, grpek: password/group file checkers pwck(IH) 

change owner and group of a file chown: chown(2) 

diff: differential file comparator diff(1) 

bdiff: file comparator for large files ... bdiff(l) 

diffj: 3-way differential file comparison diff3(1) 

fcntl; file control fcntlC?) 

fenti : file control options fcntl(5) 

public UNIX System- to-UNTX System file copy uuto, uupick: uuto(IC) 

umask: set and get file creation mask umask(2) 

selected fields of each line of a file cut: cut out cut(1) 

close; close a file descriptor close(2) 

dup: duplicate an open file descriptor dup(2) 

file; determine file type filed ) 

dump selected parts of an object file dump: dumpd ) 

putpwent: write password file entry ........................ putpwent(3C) 

setpwent, endpwent: get password file entry /getpwuid, getpwnam, ... getpwent(3C) 

endutent, utmpname: access utmp file entry /pututline, setutent, ,. getut(3C) 

exeeve, execlp, exeevp: execute a file execl, exeev, execle, exec(2) 

grep, egrep, fgrep: search a file for a pattern grepCl ) 

Idaopen; open a common object file for reading Idopen, ldopen(3X) 

acet: per-process accounting file format acct(4) 

ar : common archive file format ar(M) 

errfile; error-log file format errfile(M) 

intro; introduction to file formats intro(M) 

number entries of a common object file function /manipulate line ,,,, ldlread(3X) 

files filehdr: file header for common object filehdr(4) 

file Idfhread; read the file header of a common object .... ldfhread(3X) 

Idohseek; seek to the optional file header of a common object/ ... ldohseek(3X) 

split: split a file into pieces splitCl) 

header of a member of an archive file Idahread; read the archive ... ldahread(3X) 

Idaclose: close a common object file Idclose, ldclose(3X) 

file header of a common object file Idfhread; read the ldfhread(3X) 

retrieve symbol name for object file Idgetname: ldgetname(3’ 

symbol table of a common object file Idtbseek: seek to the ldtbseek(3Xy 
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number entries in a common object file linenum: line linenum(4) 

or a special or ordinary file mknod : make a directory, ..... mknodCP) 

a file system, ff: list file names and statistics for ..... ff(1M) 

change the format of a text file newform; newformCl) 

print name list of common object file nm: nm(1) 

/find the slot in the utmp file of the current user ttyslot(3C) 

creat: create a new file or rewrite an existing one ... creat(p) 

Iseek: move read/write file pointer lseek(?) 

rewind, ftell: reposition a file pointer in a stream fseek, ... fseek(3S) 

table entry of a common object file /read an indexed symbol ldtbread(3X) 

section header of a common object file /read an indexed/named ldshreadC3X) 

information for a common object file reloc: relocation reloc(^) 

files or subsequent lines of one file /same lines of several paste(l) 

bfs; big file scanner bfs(1) 

header for a common object file scnhdr: section scnhrir(4) 

section of a common object file /seek to an indexed/named .... ldsseek(3X) 

of a section of a common object file /seek to relocation entries .. ldrseek(3X) 

file header of a common object file /seek to the optional ldohseek(3X) 

number information from an object file /strip symbol and line stripd ) 

checksum and block count of a file sum: print sum(1) 

syms: common object file symbol table format .......... symsCM) 

mkfs: construct a file system mkfs(IM) 

mount: mount a file system mount(?) 

umount : unmount a file system umount(?) 

tapesave; daily/weekly UNIX file system backup, filesave, filesaveCiM) 

fsba: file system block analyzer fsba(IM) 

procedure, checkall: faster file system checking .............. checkalKiM) 

and interactive/ fsck, dfsck: file system consistency check fsck(IM) 

fsdb, fsdbib: file system debugger fsdb(IM) 

names and statistics for a file system, ff: list file ff(1M) 

volume file system: format of system fs(4) 

umount: mount and dismount file system, mount, mount(IM) 

ustat: get file system statistics ............ ustat(2) 

mnttab: mounted file system table mnttab(4) 

access time, dcopy: copy file systems for optimal dcopy(IM) 

checklist: list of file systems processed by fsck .... checklist(4) 

volcopy, labelit: copy file systems with label/ volcopyCIM) 

volcopy, labelit: copy file systems with label/ volcopy . 1m. old 

table entry of a common object file /the index of a symbol ldtbindexC3X) 

create a name for a temporary file tmpnam, tempnam: tmpnam(3S) 

of a section of a common object file /to line number entries ldl3eek(3X) 

and modification times of a file touch; update access touchC 1 ) 

ftw: walk a file tree ftw(3C) 

file: determine file type filed) 

umask: set file-creation mode mask umaskCl ) 

object files filehdr: file header for common ... filehdr(4) 

mktemp: make a unique filename mkterap(3C) 

ctermid : generate filename for terminal ctermid(3S) 

ferror, feof, clearerr, fileno: stream status inquiries ... ferror(3S) 

bdiff: file comparator for large files bdiffCl) 

cat: concatenate and print files catCl ) 

cmp: compare two files cmpCl ) 
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cp, In, mv: copy, link or move files cp(1) 

diffmk: mark differences between files diffmk(i) 

find: find files find(1) 

intro: introduction to special files intro(7) 

Id: link editor for common object files ld(1) 

pr : print files pr(1) 

sort: sort and/or merge files sort( 1 ) 

and print process accounting file(s) acctcom: search acctcom(l) 

merge or add total accounting files, acctmerg: acctmerg(IM) 

VAX-1 1/780/ fscv: convert files between M68000 and fscv(IM) 

reject lines common to two sorted files comm: select or comm(1) 

file header for common object files filehdr: filehdr(4) 

free: recover files from a backup tape frec(IM) 

format specification in text files fspec; fspec(4) 

split f77, ratfor, or efl files fsplit: fsplit(l) 

scat: concatenate and print files on synchronous printer ...... scat(1) 

rm, rmdir: remove files or directories rm(1) 

/merge same lines of several files or subsequent lines of one/ , paste(1) 

peat, unpack: compress and expand files pack, pack(1) 

section sizes of common object files size: print size(1) 

daily/weekly UNIX file system/ filesave, tapesave: filesave(IM) 

greek: select terminal filter greek(l) 

nl : line numbering filter nl(1) 

col; filter reverse line-feeds eoK 1 ) 

fine; fast incremental backup finc(IM) 

find: find files find(i) 

find; find files find(i) 

hyphen; find hyphenated words hyphen(l) 

ttyname, isatty: find name of a terminal ttyname(3C) 

object library lorder; find ordering relation for an lorder(l) 

hashmake, spellln, hashcheck: find spelling errors spell, spell(l) 

the current user ttyslot: find the slot in the utmp file of , ttyslot(3C) 

tee: pipe fitting tee(1) 

ichar,/ int , ifix, idint, real, float, sngl, dble, cmplx , dcmplx, . ftype(3F) 

atof: convert ASCII string to floating-point number atofCSO 

ecvt, fevt, gevt; convert floating-point number to string ... ecvt(3C) 

Idexp, modf: manipulate parts of floating-point numbers frexp, ..... frexp(3C) 

ceiling, remainder, absolute/ floor, ceil, fmod , fabs: floor, ... floor(3M) 

floor, ceil, fmod, fabs; floor, ceiling, remainder,/ floor(3M) 

cflow: generate C flow graph cflow(l) 

fclose, fflush: close or flush a stream fclose(3S) 

remainder, absolute/ floor, ceil, fmod, fabs; floor, ceiling, floor(3M) 

stream fopen, freopen, fdopen: open a .... fopen^S) 

fork; create a new process fork(2) 

acet; per-process accounting file format acct(4) 

ar: common archive file format ar(4) 

errfile: error-log file format errfile(4) 

nroff or/ eqn, neqn , checkeq; format mathematical text for eqn(l) 

newform; change the format of a text file newfonn(l) 

inode; format of an inode inode(4) 

core; format of core image file core(4) 

cpio; format of cpio archive cpio(4) 
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dir: format of directories dir(M) 

file system: format of system volume fs(4) 

files fspec: format specification in text fspec(M) 

common object file symbol table format syms: syins(M) 

tbl : format tables for nroff or troff ,, tbl(1) 

nroff: format text nroff(l) 

intro: introduction to file formats intro(M) 

utrap, wtmp: utmp and vrtmp entry formats utmp(M) 

soanf, fscanf, sscanf: convert formatted input scanf(3S) 

printf, fprintf, sprintf: print formatted output printf(3S) 

/cheokmra: print/check documents formatted with the MM macros mm(1) 

mptx: the macro package for formatting a permuted index mptxC5) 

mm: the MM macro package for formatting documents mm(5) 

OSDD adapter macro package for formatting documents mosd: the .... rnosd(5) 

manual man: macros for formatting entries in this man(5) 

output printf, fprintf, sprintf: print formatted . printfCS^') 

word on a stream putc, putohar , fputc, putw: put character or ..... putc(3S) 

puts, fputs: put a string on a stream ... puts(3S) 

input/output fread, fwrite: binary fread(3S) 

backup tape. free: recover files from a frec(IM) 

df; report number of free disk blocks df(1M) 

memory allocator malloc, free, realloc, calloc: main malloc(3C) 

fopen, freopen, fdopen: open a stream .... fopenC3S) 

parts of floating-point numbers frexp, Idexp, modf: manipulate .... frexp(3C) 

free: recover files from a backup tape frec(IM) 

gets, fgets: get a string from a stream gets(3S) 

and line number information from an object file /symbol stripCi) 

getopt: get option letter from argument vector getopt(3C) 

errdead: extract error records from dump errdeadClM) 

read : read from file read(2) 

ncheck: generate names from i-numbers ncheck(IH) 

nlist: get entries from name list nlist(3C) 

acetems: command summary from per-process accounting/ acctcmsCiM) 

getw: get character or word from stream /getchar, fgetc, ...... getc(3S) 

getpw: get name from UTD getpw(3C> 

analyzer. fsba: file system block fsba(IM) 

input scanf, fscanf, sscanf: convert formatted , scanf(3S) 

list of file systems processed by fsck checklist: checklist(4) 

consistency check and/ fsck, dfsck: file system fsck(IM) 

M68000 and VAX-1 1/780/ fsev : convert files between fscv(IM) 

debugger. fsdb, fsdbib; file system fsdb(IM) 

fsdb, fsdbib: file system debugger fsdb(IM) 

a file pointer in a stream fseek, rewind, ftell : reposition ., fseek(3S) 

text files fspec: format specification in fspec(4) 

efl files fsplit: split f77. ratfor, or fsplit(l) 

in a stream fseek, rewind, ftell: reposition a file pointer .. fseek(3S) 

ftw: walk a file tree ftw(3C) 

gamma: log gamma function gamma(3M) 

hypot: Euclidean distance function hyp>ot(3M) 

matherr : error-handling function matherr(3M) 

function erf, erfc: error function and complementary error .. erf(3M) 

function and complementary error function erf, erfc: error erf(3M) 
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entries of a common object file function /manipulate line number ldlread(3X) 

J^i jlf jn, yO, y1, yn: Bessel functions bessel(3M) 

sinh, cosh, tanh; hyperbolic functions sinh(3M) 

remainder, absolute value functions /fabs; floor, ceiling, ., floor(3M) 

300, 300s: handle special functions of DASI 3OO and 300s/ ... 300(1) 

?6?1 »-ser ies/ hp: handle special functions of HP 26M0 and hp( 1 ) 

terminal 450; handle special functions of the DASI 450 450(1) 

acos, atan, atan?: trigonometric functions sin, cos, tan, asin, .... trig(3M) 

logarithjn, power, square root functions /sqrt; exponential, exp(3M) 

fread, fwrite; binary input/output fread(3S) 

connect accounting records, fwtmp, wtmpfix: manipulate fwtmp(IM) 

jotto; secret word game jotto(6) 

moo; guessing game moo(6) 

back: the game of backgammon back(6) 

b j : the game of black jack bj(6) 

chess: the game of chess chess(6) 

craps: the game of craps craps(6) 

reversi: a game of dramatic reversals reversi(6) 

wump: the game of hunt-the-wumpus wump(6) 

intro: introduction to games intro(6) 

gamma: log gamma function gamma(3M) 

gamma: log gamma function gamma(3M) 

number to string ecvt, fcvt, gcvt: convert floating-point ecvt(3C) 

maze: generate a maze maze(6) 

abort; generate an TOT fault abort(3C) 

cflow: generate C flow graph cflow(l) 

cross-reference cxref: generate C program cxref(l) 

crypt, setkey, encrypt: generate DES encryption crypt(3C) 

makekey: generate encryption key makekey(l) 

ctermid: generate filename for terminal .... ctermid(3S) 

ncheck; generate names from i-numbers ncheck(IM) 

lexical tasks lex: generate programs for simple lex(1) 

/srand48, seed48, lcong48: generate uniformly distributed/ .., drand48(3C) 

rand, srand; simple random-number generator rand(3C) 

gets, fgets: get a string from a stream gets(3S) 

ulimit: get and set user limits ulimit(2) 

user cuserid: get character login name of the ... cu3erid(3S) 

getc, getchar, fgetc , getw; get character or word from/ getc(3S) 

nlist: get entries from name list nlist(3C) 

umask: set and get file creation mask umask(2) 

ustat: get file system statistics ustat(2) 

getlogin: get login name getlogin(3C) 

logname: get login name logname(l) 

msgget: get message queue msgget(2) 

getpw: get name from UTD getpw(3G) 

system uname; get name of current operating uname(2) 

vector getopt; get option letter from argument ... getopt(3C) 

/getpwnam, setpwent, endpwent: get password file entry getpwent(3C) 

directory getcwd : get pathname of current working ... getcwd(3C) 

times times: get process and child process tiroes(2) 

parent/ getpid, getpgrp, getppid : get process, process group, and ... getpid(2) 

getuid, geteuid, getgid, getegid; get real user, effective user,/ ... getuid(2) 
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semget: get set of semaphores semgetC?) 

shmget; get shared memory segment shmget(?) 

tty: get the terminal's name tty(1) 

time: get time time(?) 

character or word from stream getc , getchar, fgetc, getw: get ... getc(3S) 

character or word from/ getc, getchar, fgetc, getw: get getc(3S) 

working directory getcwd : get pathname of current ... getcwd(3C) 

user,/ getuid, geteuid, getgid, getegid: get real user, effective . getuid(?) 

environment name getenv: return value for getenv(3C) 

real user, effective/ getuid, geteuid, getgid, getegid; get getuid(p) 

effective user,/ getuid, geteuid, getgid, getegid; get real user, ... getuid(2) 

setgrent, endgrent: obtain getgrent, getgrgid , getgrnam, getgrent(3C) 

endgrent: obtain getgrent, getgrgid, getgrnam, setgrent, getgrentC3C) 

obtain getgrent, getgrgid, getgrnam, setgrent, endgrent; getgrent(3C) 

getlogin; get login name getlogin(3C) 

argument vector getopt ; get option letter from .... getopt(3C) 

getopt: parse command options getopt(l) 

getpass; read a password getpass(3C) 

process group, and/ getpid, getpgrp, getppid; get process, .... getpidCP) 

process, process group, and/ getpid, getpgrp, getppid; get getpid(2) 

group, and/ getpid, getpgrp, getppid; get process, process getpid(2) 

getpw: get name from UTD getpw(3C) 

setpwent, endpwent: get password/ getpwent, getpwuid, getpwnam, getpwent(3C) 

■password/ getpwent, getpwuid, getpwnam, setpwent, endpwent; get , getpwent(3C) 

endpwent; get password/ getpwent, getpwuid, getpwnam, setpwent, getpwent(3C) 

stream gets, fgets: get a string from a .. gets(3S) 

and terminal settings used by getty gettydefs; speed gettydefsC^i ) 

modes, speed, and line/ getty; set terminal type, getty(IM) 

ct; spawn getty to a remote terminal ct(1C) 

settings used by getty gettydefs: speed and terminal gettydefs(M) 

get real user, effective user,/ getuid, geteuid, getgid, getegid; , getuid(2) 

pututline, setutent, endutent,/ getutent, getutid, getutline, getutCSC) 

setutent, endutent,/ getutent, getutid, getutline, pututline, getut(3C) 

endutent,/ getutent, getutid, getutline, pututline, setutent, ... getut(3C) 

stream getc, getchar, fgetc, getw: get character or word from .. getc(3S) 

date and time/ ctime, localtime, gmtime, asctime, tzset; convert ... ctime(3C) 

setjmp, longjmp: non-local goto setjmpC3C) 

cflow: generate C flow graph cflow(l) 

sag; system activity graph sag(1 ) 

type-box greek; graphics for the extended TTY-37 .. greek(5) 

TTy-37 type-box greek; graphics for the extended .. greek(5) 

greek: select terminal filter greek(l) 

for a pattern grep, egrep, fgrep; search a file . grep(l) 

chown, chgrp; change owner or group chownd) 

newgrp: log in to a new group newgrpCi) 

/real user, effective user, real group, and effective group IDs .... getuid(2) 

/getppid: get process, process group, and parent process IDs getpid(2) 

group: group file group(M) 

group; group file group(4) 

setpgrp: set process group ID setpgrp(2) 

setuid, setgid; set user and group IDs setuid(2) 

id; print user and group IDs and names id(i) 
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user, real group, and effective group IDs /real user, effective ... getuld( 2 ) 

chovm: change owner and group of a file chownC?) 

send a signal to a process or a group of processes kill: kill(P) 

maintain, update, and regenerate groups of programs make: make( 1 ) 

checkers, pwck, grpck: password/group file pwck(IM) 

ssignal, gsignal: software signals ssignaKSC) 

hangman: guess the word hangman( 6 ) 

moo: guessing game moo( 6 ) 

300 and 300s/ 300 , 300s: handle special functions of DASI .. 300(1) 

26M0 and ?621 -^series/ hp: handle special functions of HP .... hp( 1 ) 

DASI M 50 terminal 450: handle special functions of the ... 450(1) 

hangman: guess the word ........... hangman( 6 ) 

nohup: run a command immune to hangups and quits nohup(l) 

hcreate, hdestroy: manage hash search tables hsearch, hsearch(3C) 

spell, hashmake, spellin, hashcheck: find spelling errors ... spell(l) 

find spelling errors spell, hashmake, spellin, hashcheck: spell(l) 

search tables hsearch, hcreate, hdestroy: manage hash .... hsearch( 3 C) 

tables hsearch, hcreate, hdestroy: manage hash search hsearch( 3 C) 

aouthdr: optional aout header aouthdr(4) 

scnhdr: section header for a common object file ... scnhdr(4) 

filehdr: file header for common object files .... filehdr(4) 

Idfhread: read the file header of a common object file .... ldfhread(3X) 

/seek to the optional file header of a common object file .... ldoh3eek(3X) 

/read an indexed/named section header of a common object file .... ldshread(3X) 

file Idahread : read the archive header of a member of an archive .. ldahread(3X) 

help: ask for help help( 1 ) 

help: ask for help help( 1 ) 

hp: handle special functions of HP 2640 and 2621-series/ hp(1) 

HP 2640 and 2621-series/ hp: handle special functions of ... hp( 1 ) 

manage hash search tables hsearch, hcreate, hdestroy: ....... hsearch(3C) 

. wump: the game of hunt-the-wumpus wump( 6 ) 

sinh, cosh, tanh: hyperbolic functions sinh(3M) 

hyphen: find hyphenated words hyphen(l) 

hyphen: find hyphenated words hyphenCi) 

function hypot: Euclidean distance hypot(3M) 

setpgrp: set process group ID 3etpgrp(2) 

names id: print user and group IDs and id(l) 

semaphore set or shared memory id /remove a message queue, ....... ipcrm(l) 

issue: issue identification file issue(4) 

cmplx, dcmplx, ichar,/ int , ifix, idint, real, float, sngl, dble, ... ftype(3F) 

id: print user and group IDs and names id( 1 ) 

process group, and parent process IDs /getppid: get process, getpid(2) 

real group, and effective group IDs /real user, effective user, ... getuid(2) 

setgid; set user and group IDs setuid , setuid(2) 

dble, cmplx, dcmplx, ichar,/ int, ifix, idint, real, float, sngl, ... ftype( 3 F) 

core: format of core image file core( 4 ) 

crash: examine system images crash(IM) 

nohup: run a command immune to hangups and quits nohup(l) 

fine: fast incremental backup finc(IM) 

long integer data in a machine independent fashion, /access sputl(3X) 

/tgetstr, tgoto, tputs: terminal independent operation routines .... termcap( 3 ) 

ptx: permuted index ptx( 1 ) 
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package for formatting a permuted index mptx: the macro mptx(5) 

a common/ Idtbindex: compute the index of a symbol table entry of Id tbindex ( 3X ) 
common object/ Idtbread: read an indexed symbol table entry of a ... ldtbread(3X) 

a/ Idshread, Idnshread: read an indexed/named section header of ... ldshreadC3X/ 

Idsseek, Idnsseek: seek to an indexed/named section of a/ ldsseek(3X) 

inittab: script for the init process inittab(M) 

initialization. init, telinit; process control .... init(IM) 

init, telinit; process control initialization init(IM) 

/rc , power fail: system initialization shell scripts. brc(IM) 

px^pen, pclose : initiate pipe to/from a process ... popenC3S) 

process inittab: script for the init ...... inittab(4) 

clri: clear i-^node clri(IM) 

inode; form.at of an inode inode(4) 

inode; format of an inode inode(4) 

fscanf, sscanf; convert formatted input scanf, scanf(3S) 

ungetc: push character back into input stream ungetc(3^) 

fread, fvrrite; binary input/output fread(3S) 

stdio; standard buffered input/output package stdio(3^) 

clearerr, fileno: stream status inquiries ferror, feof, ferror(3S) 

uustat: UUCP status inquiry and job control uustat(IC) 

install; install commands install(IM) 

install; install commands instalKiM) 

sngl, dble, cmplx , dcmplx,/ int, ifix, idint, real, float, .... ftype(3F) 

abs; return integer absolute value abs(3C) 

a641, 164a: convert between long integer and base-64 ASCII string .. a641(3C) 

sputl, sgetl: access long integer data in a machine/ sputl(3X) 

atol , atoi: convert string to integer strtol, strtol(3C) 

/ltol3: convert between 3-byte integers and long integers 13tolC3C) 

between 3^hyte integers and long integers 13tol, ltol3: convert .... 13tol(3C) 

bcopy: interactive block copy bcopy(IM) 

system consistency check and interactive repair, /file fsckClM) 

rjestat; HJE status report and interactive status console ........ rjestat(ic) 

cat; phototypesetter interface cat(7) 

err; error-logging interface err (7) 

termio: general terminal interface termio(7) 

tty; controlling terminal interface tty(7) 

characters asa: interpret ASA carriage control .... asa(1) 

sno : SNOBOL interpreter sno(1) 

pipe; create an interprocess channel pipe(2) 

facilities status ipcs; report inter-process conmuni cation ipcs(1) 

package stdipc; standard interprocess communication stdipc(3C) 

sleep: suspend execution for an interval sleepCl) 

sleep: suspend execution for interval sleep(3C) 

subroutines and libraries intro: introduction to intro(3) 

miscellaneous facilities intro: introduction to intro(5) 

and application programs intro; introduction to commands ... intro(l) 

formats intro: introduction to file intro(4) 

intro: introduction to games intro(6) 

files intro: introduction to special .... intro(7) 

maintenance commands and/ intro: introduction to system intro(IM) 

calls and error numbers intro: introduction to system intro(2) 

maintenance procedures intro: introduction to system intro(8) 
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application programs intro: introduction to commands and intro(l) 

intro: introduction to file formats intro(M) 

intro: introduction to games intro(6) 

facilities intro: introduction to miscellaneous introC*:) 

intro: introduction to special files intro(7) 

libraries intro: introduction to subroutines and ,,, intro(3) 

maintenance commands/ intro: introduction to system intro(IM) 

maintenance procedures intro: introduction to system intro(8) 

error numbers intro: introduction to system calls and intro(?) 

ncheck: generate names from i~numbers ncheck(iM) 

ioctl; control device ioctK?) 

abort: generate an lOT fault abort(3C) 

semaphore set or shared memory/ ipcrm: remove a message queue, .... ipcrmCi) 

communication facilities status ipcs: report inter-process ipcs(1) 

/islower, isdigit, isxdigit, isalnum, isspace, ispunct,/ ctype(3tion 

section header of a/ Idshread, Idnshread: read an indexed/named ,, ldshread(3X) 

indexed/named section/ Idsseek, Idnsseek: seek to an ldsseek(3X) 

file header of a common object/ Idohseek; seek to the optional .... ldohseek(3X) 

object file for reading Idopen, Idaopen: open a common .... ldopen(3X) 

relocation entries of a section/ Idrseek, Idnrseek; seek to ldrseek(3X) 

indexed/named section header of/ Idshread, Idnshread: read an ldshread(3X) 

indexed/named section of a/ Idsseek, Idnsseek: seek to an ..... ldsseek(3X) 

symbol table entry of a common/ Idtbindex: compute the index of a . ldtbindex(3X) 
table entry of a common object/ Idtbread: read an indexed symbol .. ldtbread(3X) 

table of a common object file Idtbseek: seek to the symbol ldtbseek(3X) 

getopt: get option letter from argument vector getopt(3G) 

lexical tasks lex: generate programs for simple . lex(1) 

lex: generate programs for simple lexical tasks lex(1) 

introduction to subroutines and libraries intro: intro(3) 

ordering relation for an object library lorder : find lorder(l) 

archives ar : archive and library maintainer for portable ... ar(1) 

ulimit: get and set user limits ulimit(2) 

line: read one line lined) 

establish an out-going terminal line connection dial: dial(3C) 

type, modes, speed, and line discipline, /set terminal .... gettyClM) 

object file linenum: line number entries in a common ... linenum(4) 

/Idlinit, Idlitem: manipulate line number entries of a common/ .. ldlread(3X) 

of a/ Idlseek, Idnlseek: seek to line number entries of a section ., ldlseek(3X) 

object/ strip: strip symbol and line number information from an ... stripCl) 

nl : line numbering filter nl(1) 

cut out selected fields of each line of a file cut: ............... cut(1) 

Ipd: line printer daemon IpdCic) 

send/cancel requests to an LP line printer Ip, cancel: lp(1) 

Ipr: line printer spooler lpr(1) 

line: read one line lined) 

Isearch: linear search and update lsearch(3C) 

col: filter reverse line- feeds cold) 

common object file linenum: line number entries in a . linenum(4) 
comm: select or reject lines common to two sorted files commd) 

uniq: report repeated lines in a file uniqd) 

of several files or subsequent lines of one file /same lines paste(l) 

subsequent/ paste: merge same lines of several files or pasted) 
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link, unlink: exercise link and unlink system calls link(IM) 

files Id: link editor for common object ld(1) 

a. out: common assembler and link editor output a.out(4) 

link: link to a file link(P) 

cp, In, mv; copy, link or move files cp(1) 

link: link to a file link(?) 

and unlink system calls. link, unlink: exercise link link(IM) 

lint: a C program checker lint(1) 

nlist; get entries from name list nlist(3C) 

Is: list contents of directories ls(1) 

for a file system, ff: list file names and statistics ff(1M) 

nm: print name list of common object file nraCD 

fsck checklist: list of file systems processed by . checklist(M) 

associated with a/ sparelist: list the spared sectors sparelist(8.) 

xargs: construct argument list(s) and execute command xargs(l) 

cp, In, mv: copy, link or move files .. cp(1) 

tzset: convert date and/ ctime, localtime, gmtiroe, asctime, ctimeC3C) 

end, etext, edata: last locations in program end(3C) 

memory plock: lock process, text, or data in .... plock(2) 

gamma: log gamma function gamma(3K) 

newgrp; log in to a new group newgrp(l) 

exponential, logar ithjc ,/ exp, log, logic, pow, sqrt: exp(3M) 

logarithm, power,/ exp, log, logic, pow, sqrt: exponential, .... exp(3H) 

/logic, pow, sqrt: exponential, logarithm, power, square root/ .... exp(3M) 

errpt: process a report of logged errors errpt(IM) 

getlogin: get login name getlogin(3C) 

logname: get login name lognameC 1 ) 

cuserid: get character login name of the user cu3erid(3S) 

logname: return login name of user lognameC 3X) 

passwd : change login password passwd(l) 

login: sign on login(l) 

setting up an environment at login time profile: profile(M) 

logname: get login name lognameC 1) 

user logname: return login name of lognameC3X) 

a6Ml, 164a: convert between long integer and base-64 ASCII/ ... a64lC3C> 

independent/ sputl , sgetl : access long integer data in a machine .... sputlC3X) 

between 3-byte integers and long integers /ltol3: convert 13tolC3C) 

setjmp, longjmp: non-local goto setjmpCBO 

for an object library lorder: find ordering relation .... lorderCl) 

nice: run a command at low priority niceCi) 

to an LP line printer Ip, cancel: send/cancel requests .. IpCD 

send/cancel requests to an LP line printer Ip, cancel; IpCD 

enable, disable: enable/disable LP printers enableCi) 

/Ipshut, Ipmove: start/ stop the LP request scheduler and move/ .... IpschedClM) 

accept, reject: allow/ prevent LP requests accept(IM) 

Ipadmin: configure the LP spooling system IpadminClM) 

Ipstat: print LP status information IpstatCl) 

spooling system. Ipadmin: configure the LP IpadminClM) 

Ipd: line printer daemon IpdCiC) 

request/ Ipsched , Ipshut, Ipmove: start/ stop the LP IpschedClM) 

Ipr: line printer spooler IprCl) 

start/ stop the LP request/ Ipsched, Ipshut, Ipmove; IpschedClM) 
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LP request scheduler/ Ipsched, Ipshut, Iptnove: start/ stop the Ipsched (1M) 

information Ipstat: print LP status Ipstat(l) 

jrand43,/ drandMS, erand48, lrand48, nrandUS, mrandUS, drand48(3C) 

Is: list contents of directories .. ls(1) 

update Isearch: linear search and lsearch(3C) 

pointer Iseek: move read/write file IseekC?) 

integers and long/ 13 tol , ltol3: convert between 3-byte 13tolC3C) 

m4: macro processor m4(1) 

fscv: convert files between M68000 and VAX-11/780/ fscv(IM) 

your processor/ pdpii, u3b, vax, m68k: provide truth value about raachid(l) 

/access long integer data in a machine independent fashion sputl(3X) 

dociments mm: the MM macro package for formatting mm(5) 

mosd : the OSDD adapter macro package for formatting/ mosd(5) 

permuted index mptx : the macro package for formatting a .... mptx(5) 

viewgraphs and/ mv ; a troff macro package for typesetting mv(5) 

m4 : macro processor ro4(1) 

documents formatted with the MM macros /checkmm: print/check mm(1) 

this manual man: macros for formatting entries in man(5) 

rmail: send mail to users or read mail mail mail(l) 

or read mail mail, rmail: send mail to users ... mail(l) 

mail, rmail; send mail to users or read mail mail(l) 

malloc, free, realloc, calloc: main memory allocator malloc(3C) 

groups of programs make: maintain, update, and regenerate make(l) 

ar ! archive and library maintainer for portable archives ,, ar(1) 

intro: introduction to system maintenance commands and/ intro(IM) 

intro: introduction to system maintenance procedures intro(8) 

mkdir: make a directory mkdir(l) 

ordinary file mknod ; make a directory, or a special or . mknod(2) 

mkterap: make a unique filename mktemp(3C) 

regenerate groups of programs make: maintain, update, and make(l) 

banner: make posters banner(l) 

makekey: generate encryption key .. makekey(l) 
main memory allocator malloc, free, realloc, calloc; .... malloc(3C) 

entries in this manual man: macros for formatting man(5) 

onyx: Onyx 6810 special system service onyx(2) 

service onyx: Onyx 6810 special system .... onyx(2) 

one spare; replace a bad sector with a spare . spare(8) 

spare: replace a bad sector with a spare one spare(8) 

sparelist: list the spared sectors associated with a slice ... sparelist(8) 

onyx: Onyx 6810 special system service onyx(?) 

spared sectors associated with a slice sparelist: list the sparelist(8) 

replace a bad sector with a spare one spare; spare(8) 

a spare one spare; replace a bad sector with ,. spare(8) 

slice sparelist: list the spared sectors associated with a .. sparelist(8) 

sectors associated with a slice sparelist: list the spared sparelist(8) 

onyx: Onyx 6810 special system service onyx(2) 

adduser: add a user to the system adduser(IM) 

onyx: Onyx 6810 special system service onyx(2) 

checkcw; prepare constant-width text for troff cw, cw( 1 ) 

plock: lock process, text, or data in memory plockC?) 

tgetstr, tgoto, tputs: terminal/ tgetent, tgetnum, tgetflag, termcap(3) 

terminal/ tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs; .. termcap(3) 
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tgoto, tputs: terminal/ tgetent, tgetnum , tgetflag, tgetstr, termcap(3) 

tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: terminal/ .. termcapO) 

tg etnum, tgetflag, tgetstr, tgoto, tputs: terminal/ tgetent, ,, termcapO) 

ttt , cubic: tic-tac-toe ttt(6) 

stime: set time stime(2) 

time: get time time(2) 

time: time a command time(l) 

data and system activity timex : time a command; report process .... timex(l) 

systems for optimal access time, dcopy: copy file dcopy(IM) 

time: get time time(2) 

profil: execution time profile profil(2) 

up an environment at login time profile: setting profile(U) 

time: time a command timed) 

asctime, tzset: convert date and time to string /gmtime, ctime(3C) 

clock: report CPU time used clock(3C) 

process times times: get process and child times(?) 

update access and modification times of a file touch; touch(l) 

get process and child process times times: timesC?) 

set file access and modification times utime: utime(2) 

process data and system/ timex: time a command; report timex(l) 

tmpfile: create a temporary file .. tmpfile(3S) 
for a temporary file tmpnam, tempnam: create a name ,,,, tmpnara(3S) 
/tolower, _toupper, ^tolower, toascii: translate characters ..... conv(3C) 

■popen, pclose: initiate pipe to/from a process popen(3?) 

toupper, tolower, _toupper , __tolower, toascii; translate/ conv(3C) 

toascii: translate/ toupper, tolower, _toupper, __tolower, conv(3C) 

tsort: topological sort tsort(l) 

acctmerg; merge or add total accounting files acctmerg(IM) 

modification times of a file touch: update access and touchCl) 

translate/ toupper, tolower, _^toupper, __tolower , toascii: conv(3C) 

^tolower, toascii: translate/ toupper, tolower, ^toupper, conv(3C) 

/tgetflag, tgetstr, tgoto, tputs: terminal independent/ termcap(3) 

tr : translate characters tr(1) 

ptrace: process trace ptrace(?) 

trace; event*- tracing driver traceC?) 

tr ; translate characters .............. tr(1) 

^toupper, ^tolower, toascii: translate characters /tolower, .... conv(3C) 

ftw: walk a file tree ftw(3C) 

twalk: manage binary search trees tsearch, tdelete, t5earch(3C) 

tan, asin, acos, atan, atan2: trigonometric functions /cos, trig(3M) 

tbl : format tables for nroff or troff tbl(1) 

prepare constant-width text for troff cw, checkcw: cw(1) 

typesetting viewgraphs and/ mv: a troff macro package for mvCS) 

mathematical text for nroff or troff /neqn, checkeq; format ...... eqn(1) 

troff; typeset text troff(l) 

values true, false; provide truth trued ) 

pdpli, u3b, vax, m68k: provide truth value about your processor/ , machidd) 

true, false: provide truth values trued) 

binary search trees tsearch, tdelete, twalk; manage .,. tsearch(3C) 

tsort; topological sort tsortCl) 

ttt, cubic; tic-tac-toe ttt(6) 

interface tty; controlling terminal tty(7) 
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tty: get the terminal's name tty(1) 

greek: graphics for the extended TTY-S? type-box greek(5) 

terminal ttyname, isatty: find name of a ... ttyname(3C) 

utmp file of the current user ttyslot: find the slot in the ..... ttyslot(5C) 

/runacct, shutacct, startup, turnacct: shell procedures for/ ... acctsh(IM) 

trees tsearch, tdelete, twalk; manage binary search ....... tsearch(3C) 

file: determine file type filed) 

getty: set terminal type, modes, speed, and line/ gettyClM) 

truth value about your processor type /u3b, vax, m68l<; provide machid(l) 

graphics for the extended TTY-37 type-box greek: greek(5) 

types: primitive system data types types(5) 

types types: primitive system data types(5) 

and slides mmt, mvt: typeset documents, viewgraphs, .... mratCl) 

troff: typeset text troffd ) 

mv : a troff macro package for typesetting viewgraphs and/ mv(5) 

/localtime, gmtime, asctime, tzset: convert date and time to/ ., ctime(3C) 

value about your/ pdpll, u3b, vax, m68k: provide truth ..... machid(l) 

getpw: get name from UTD getpw(3C) 

ulimit: get and set user limits ... ulimitC?) 
mask umask: set and get file creation .. umaskC?) 

mask umask; set file-creation mode umask(l) 

file system, mount, umount: mount and dismount mount(IM) 

umount: unmount a file system umountC?) 

operating system uname: get name of current uname(?) 

System uname: print name of current UNIX . uname( 1 ) 
input stream ungetc: push character back into ,. ungetc(3S) 

seed48, lcong48: generate uniformly distributed/ /srand48, .. drand48(3C) 

file uniq: report repeated lines in a .. uniqCl) 

ffiktemp: make a unique filename mktemp(3C) 

units: conversion program unitsd) 

config: configure UNIX SYSTEM V config .68(1M) 

cu: call another UNIX SYSTEM V system cu(1C) 

unlink system calls, link, unlink: exercise link and link(IM) 

unlink: remove directory entry .... unlinkC?) 

unlink: exercise link and unlink system calls, link, link(IM) 

umount: unmount a file system umountC 2) 

files pack, peat, unpack: compress and expand packCD 

Isearch; linear search and update lsearch(3C) 

times of a file touch: update access and modification .... touch(l) 

programs make*, maintain, update, and regenerate groups of make(l) 

sync: update super-block sync (2) 

sync: update the super block sync(1) 

du: summarize disk usage du(1) 

logname: return login name of user logname(3X) 

su: become superuser or another user su(1) 

write: write to another user write(1) 

setuid, setgid: set user and group IDs setuid(2) 

id: print user and group IDs and names id(1) 

get character login name of the user cuserid: cu3erid(3S) 

and/ /getgid, getegid : get real user, effective user, real group, . getuid(2) 

environ: user environment environCS) 

ulimit: get and set user limits ulimit(2) 
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J /getegid : get real user, effective user, real group, and effective/ ,, getuid(2) 

adduser: add a user to the system adduser(IM) 

in the utmp file of the current user ttyslot; find the slot ttyslot(3C) 

wall: write to all users walKiM) 

editor (variant of ex for casual users) edit: text edit(1) 

mail, rmail: send mail to users or read mail maiKl) 

statistics ustat: get file system ustat(P) 

modification times utime; set file access and utime(P) 

utmp, wtmp: utmp and wtmp entry formats utmp(M) 

endutent, utmpname: access utmp file entry /setutent, ........ getut(3C) 

ttyslot: find the slot in the utmp file of the current user ..... ttyslot(3C) 

formats utmp, wtmp: utmp and wtmp entry ... utmp(4) 

/pututline, setutent, endutent, utmpname; access utmp file entry getut(3C) 

clean-up. uuclean; uucp spool directory uuclean(IM) 

uusub: monitor uucp network uusub(IM) 

uuclean: uucp spool directory clean-up uucleandM) 

control uustat: uucp status inquiry and job uustat(IC) 

copy uucp, uulog, uuname: unix to unix . uucp(IC) 
uucp, uulog, uuname: unix to unix copy .. uucp(IC) 

uucp, uulog, uuname: unix to unix copy uucp(IC) 

System-to-UNIX System file/ uuto , uupick: public UNIX uuto(IC) 

job control uustat: uucp status inquiry and ... uustat(IC) 

uusub: monitor uucp network uusubdM) 

System-to-UNTX System file copy uuto, uupick: public UNIX uuto(IC) 

execution uux : unix to unix command uux(lC) 

/ abs: return integer absolute value abs(3C) 

/u3b, vax, m68k: provide truth value about your processor type ,,, machid(l) 

getenv: return value for environment name getenv(3C) 

ceiling, remainder, absolute value functions /fabs: floor, ..... floorCSM) 

true, false; provide truth values trued ) 

edit: text editor (variant of ex for casual users) .. editCl) 

about your processor/ pdpii, u3b, vax, m68k: provide truth value machidd) 

/files between M68000 and VAX-1 1/780 processors fscvClM) 

vc: version control vc(1) 

get option letter from argument vector getopt: getopt(3C) 

assert: verify program assertion assert(3X) 

vpr: Versatec printer spooler vpr(1) 

vc: version control vc(1) 

display editor based on ex vi: screen oriented (visual) viCl) 

mmt, mvt: typeset documents, viewgraphs, and slides romtCl) 

macro package for typesetting viewgraphs and slides /a troff .... mvCS) 

ex vi: screen oriented (visual) display editor based on .. vi(1) 

systems with label checking. volcopy, labelit: copy file volcopydM) 

systems with label checking. volcopy, labelit: copy file volcopy. Iro. old 

file system: format of system volume fs(4) 

vpr: Versatec printer spooler vpr(l) 

process wait: await completion of wait(1) 

terminate wait: wait for child process to stop or . wait(2) 

stop or terminate wait: wait for child process to ... wait(2) 

ftw: walk a file tree ftw(3C) 

wall: write to all users. walKlM) 

/ wc : word count wed) 
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signal signal: specify what to do upon receipt of a signaKP) 

signal signal: specify what to do upon receipt of a ...... signal .?.ol'^ 

crashes crash; what to do when the system crash. [n68(8 ) 

whodo: who is doing what whodo(IM) 

who; who is on the system who(1) 

who: who is on the system who(1) 

whodo: who is doing what whodo(IM) 

cd ; change working directory cd(1) 

chdir: change working directory chdir(2) 

getcwd : get pathname of current working directory getcwd(3C) 

pwd ; working directory name pwd(i) 

write: write on a file write(?) 

putpwent; write password file entry putpwent(3G) 

wall: write to all users walldM) 

write: write to another user writed) 

write: write on a file writeC?) 

write: write to another user ...... wrlteCl) 

open: open for reading or writing open(?) 

utmp, wtmp: utmp and wtmp entry formats utnip(4) 

formats utmp, wtmp; utmp and wtmp entry utmp(4) 

accounting records, fwtmp, wtmpfix: manipulate connect fwtmpClM) 

hunt-the-wumpus wump: the game of wurap(6) 

and execute command xargs: construct argument list(s) . xargsCl ) 

jO, j1, jn, yO, y1, yn: Bessel functions ...... bessel(3M) 

j1. jn, yO, y1, yn: Bessel functions bessel(3M) 

compiler-compiler yaco: yet another yaccd) 

jO, j1, jn, yO, y1, yn: Bessel functions bessel(3M) 
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NAME 

intro - introduction to system calls and error numbers 
SYNOPSIS 

#include <errno.h> 

DESCRIPTION 

This section describes all the system calls. Most of these 
calls have one or more error returns. An error condition is 
indicated by an otherwise impossible returned value. This 
is almost always -1; the individual descriptions specify the 
details. An error number is also made available in the 
external variable err no , E rr no is not cleared on successful 
calls, so it should be tested only after an error has been 
indicated , 

All the possible error numbers are not listed in each system 
call description because many errors are possible for most 
of the calls. The following is a complete list of the error 
numbers and their names as defined in <errno,h>, 

1 EPEPM Not owner 

Typically this error indicates an attempt to modify a 
file in some way forbidden except to its owner or 
superuser. It is also returned for attempts by ordi- 
nary users to do things allowed only to the superuser, 

2 ENOENT No such file or directory 

This error occurs when a filename is specified and the 
file should exist but doesn’t, or when one of the 
directories in a pathname does not exist, 

3 ESPCH No such process 

No process can be found corresponding to that specified 
by the process identifier ( pi d ) in ki 1 1 ( 2 ) or 
pt r ac e ( 2 ) , 

4 EINTP Interrupted system call 

An asynchronous signal (such as interrupt or quit), 
which the user has elected to catch, occur red during a 
system call. If execution is resumed after processing 
the signal, it will appear as if the interrupted system 
call returned this error condition, 

5 EIO I/O error 

Some physical I/O error. This error may in some cases 
occur on a call following the one to which it actually 
applies, 

6 ENXTO No such device or address 

I/O on a special file refers to a sub device which does 
not exist; or the I/O is beyond the limits of the 
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devicf?. This error may also occur when, for example, a 
tape drive is not on-line or no disk pack is loaded on 
a drive, 

7 E2BIG Arg list too long 

An argument list longer than 5,120 bytes is presented 
to a member of the e x ec ( 2 ) family. 

8 ENOEXEC Exec format error 

A request is made to execute a file which, although it 
has the appropriate permissions, does not start with a 
valid magic number (see a. out (M)). 

9 EBADF Bad file number 

Either a file descriptor refers to no open file or a 
read (respectively write) request is made to a file 
which is open only for writing (respectively reading). 

10 ECHTLD No child processes 

A wa i t ( 2 ) was executed by a process that had no exist- 
ing or unwaited-for child processes, 

11 EAGATN No more processes 

A f o r k ( 2 ) failed because the system's process table is 
full or the user is not allowed to create any more 
processes, 

12 ENOMEM Not enough space 

During an ex ec ( 2 ) , br k( 2 ) , or sbr k ( 2 ) call, a program 

asked for more space than the system is able to supply. 

Th'i s is not a temporary condition; the maximum space 
size is a system parameter. The error may also occur 
if the arrangement of text, data, and stack segments 
requires too many segmentation registers, or if there 
is not enough swap space during a for k ( 2 ) . 

13 EACCES Permission denied 

An attempt was made to access a file in a way forbidden 
by the protection system, 

14 EFAULT Bad address 

The system encountered a hardware fault in attempting 
to use an argument of a system call, 

15 ENOTBLK Block device required 

A non-block file was mentioned where a block device was 
required, e,g,, in moun t ( 2 ) , 

16 EBUSY Mount device busy 

An attempt was made to mount a device that was already 
mounted or an attempt was made to dismount a device on 
which there is an active file (open file, current 
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directory, mounted-on file, active text segment). This 
error also occurs if an attempt is made to enable 
accounting when it is already enabled. 

17 EEXIST File exists 

An existing file was mentioned in an inappropriate con- 
text, e . g . , l__i nj< ( 2 ) . 

18 EXDEV Cross-device link 

A link to a file on another device was attempted, 

19 ENODEV No such device 

An attempt was made to apply an inappropriate system 
call to a device; e.g,, read a write-only device, 

20 ENOTDTP Not a directory 

A non-directory was specified where a directory is 
required; e.g., in a path prefix or as an argument to 
c h d i r ( 2 ) . 

21 El S DIR Is a directory 

An attempt was made to write on a directory. 

22 EINVAL Invalid argument 

Some invalid argument (e.g,, dismounting a non-mounted 
device; mentioning an undefined signal in si gnal ( 2 ) , or 
ki 1 1 ( 2 ) ; reading or writing a file for which 1 se ek ( 2 ) 
has generated a negative pointer). Also set by the 
math functions described in the (3M) entries of this 
m an ua 1 . 

23 ENFILE File table overflow 

The system’s table of open files is full, and tem- 
porarily o pen ( 2 ) cannot be accepted, 

24 EMFILE Too many open files 

No process may have more than 20 file descriptors open 
atatime, 

25 ENOTTY Not a typewriter 

26 ETXTBSY Text file busy 

An attempt was made to execute a pure-procedur e program 
which is currently open for writing or reading. This 
error also indicates an attempt to open for writing a 
pur e-proced ur e program that is being executed. 

27 EFBIG File too large 

The size of a file exceeded the maximum file size 
( 1,082,201,088 bytes) or ULIMIT; see ul im i t ( 2 ) . 

28 ENOS PC Nospaceleftondevice 
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During a wr i t e ( 2 ) to an ordinary file, there is no free 
space left on the device. 

29 ESPIPE Illegal seek 

An 1 s e e k ( 2 ) was issued to a pipe. 

30 EPOFf Read-only file system 

An attempt to modify a file or directory was made on a 
device mounted read-only. 

31 EMLTNK Too many links 

An attempt was made to make more than the maximum 
number of links (1000) to a file. 

32 EPIPE Broken pipe 

An attempt was made to write on a pipe for which there 
is no process to read the data. This condition nor- 
mally generates a signal; the error is returned if the 
signal isignored. 

33 EDOM Math argument 

The argument of a function in the math package (3M) is 
out of the domain of the function. 

3^ EPANGE Result too large 

The value of a function in the math package (3M) is not 
representable within machine precision. 

35 ENOMSG No message of desired type 

An attempt was made to receive a message of a type that 
does not exist on the specified message queue; see 
m sgop ( 2 ) . 

36 EIDPM Identifier Removed 

This error is returned to processes that resume execu- 
tion due to the removal of an identifier from the file 
system’s name space (see m sg c tl ( 2 ) , seme tl ( 2 ) , and 
shmc tl ( 2 ) ) . 


37 

ECHPNG 

Channel 

number out of range 

38 

EL2NSyNC 

Level 

2 not synchronized 

39 

EL3HLT 

Level 3 

halted 

40 

EL3RST 

Level 3 

reset 

41 

ELNFNG 

Link number out of range 

42 

EUNATCH 

Protocol driver not attached 

43 

EN0C$I 

No CSI 

structure available 
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44 EL2HLT Level 2 halted 

45 EDEADLOCK File locking deadlock situation 

46 ENOSHP Not a binary shareable file 

DEFINITIONS 
Process ID 

Each active process in the system is uniquely identified by 
a positive integer called a process ID, The range of this 
ID is from 0 to 30 , 00 b, 

Parent Process ID 

A new process is created by a currently active process; see 
f or k ( 2 ) . The parent process ID of a process is the process 
ID of its creator. 

Process Group ID 

Each active process is a member of a process group that is 
identified by a positive integer called the process group 
ID. This ID is the process ID of the group leader. This 
grouping permits the signaling of related processes; see 
kill (2) . 

Tty Group ID 

Each active process can be a member of a terminal group that 
is identified by a positive integer called the tty group ID, 
This grouping is used to terminate a group of related 
processes upon termination of one of the processes in the 
group; see ex i t ( 2 ) and si gnal ( 2 ) , 

Real User ID and Real Group ID 

Each user allowed on the system is identified by a positive 
integer called a real user ID, 

Each user is also a member of a group. The group is identi- 
fied by a positive integer called the real group ID, 

An active process has a real user ID and real group ID that 
are set to the real user ID and real group ID of the user 
responsible for the creation of the process. 

Effective User ID and Effective Group ID 

An active process has an effective user ID and an effective 
group ID that are used to determine file access permissions 
(see below). The effective user ID and effective group ID 
are equal to the process’s real user ID and real group ID 
unless the process or one of its ancestors evolved from a 
file that had the set-user-ID bit or set-group-ID bit set; 
see ex ec ( 2 ) , 

Superuser 
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A process is recognized as a super use r process and is 
granted special privileges if its effective user ID is 0, 

Special Processes 

The processes with a process ID of 0 and a process ID of 1 
are special processes and are referred to as pr o c 0 and 
proc 1 . 


ProcQ is the scheduler. Prod is the initialization process 
( in i t ) « Proci is the ancestor of every other process in the 
system and is used to control the process structure, 

Fil ename , 

Names consisting of 1 to 14 characters may be used to name 
an ordinary file, special file, or directory. 

These characters may be selected from the set of all charac- 
ter values excluding \0 (null) and the ASCII code for / 
(slash). 

Note that it is generally unwise to use », ?, [, or ] as 

part of filenames because of the special meaning attached to 
these characters by the shell; see _^( 1 ) . Although permit- 
ted, it is advisable to avoid the use of unprintable charac- 
ters in filenames. 

Pathname and Path Prefix 

A pathname is a null-terminated character string starting 
with an optional slash (/), followed by zero or more direc- 
tory names separated by slashes, optionally followed by a 
f i 1 enam e , 

More precisely, a pathname is a nul 1-terminated character 
string constructed as follows: 

<pathname> ; :=<filename> !<path-prefix><filename> | / 
<path-prefix> : :=<rtprefix> i/<rtprefix> 

<rtprefix> : : =<dirname>/l <rtprefix><dirname>/ 

where < f i 1 ename > is a string of 1 to 14 characters other 
than the ASCII slash and null, and < d ir nam e> is a string of 
1 to 14 characters (other than the ASCII slash and null) 
that names a directory. 

If a pathname begins with a slash, the path search begins at 
the root directory. Otherwise, the search begins from the 
current working directory, 

A slash by itself names the root directory. 

Unless specifically stated otherwise, the null pathame is 
treated as if it named a non-existent file. 
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Directory, 

Directory entries are called links. By convention, a direc- 
tory contains at least two links, , and referred to as 

dot and dot-dot, respectively. Dot refers to the directory 
itself and dot-dot refers to its parent directory. 

Foot Directory and Current Working Directory. 

Each process has associated with it a concept of a root 
directory and a current working directory for the purpose of 
resolving pathname searches, A process’s root directory 
need not be the root directory of the root file system. 

File Access Permissions. 

Pead, write, and execute/search permissions on a file are 
granted to a process if one or more of the following are 
true: 

The process’s effective user ID is superuser. 

The process’s effective user ID matches the user ID of 
the owner of the file and the appropriate access bit of 
the ''owner’’ portion (0700) of the file mode is set. 

The process’s effective user ID does not match the user 
ID of the owner of the file, and the process’s effec- 
tive group ID matches the group of the file and the 
appropriate access bit of the ''group’’ portion (070) 
of the file mode is set. 

The process’s effective user ID does not match the user 
ID of the owner of the file, and the process’s effec- 
tive group ID does not match thegroup ID of the file, 
and the appropriate access bit of the ''other’’ portion 
( 07 ) of the file mode is set. 

If none of these conditions exists, the corresponding per- 
missions are denied. 

Message Queue Identifier 

A message queue identifier (msqid) is a unique positive 
integer created by a msgget ( 2 ) system call. Each msqid has 
a message queue and a data structure associated with it. 
The data structure is referred to as msqid ds and contains 
the following members: 

struct ipc__perm msg__perm; /* operation permission struct */ 

ushort msg_qnum; /* number ofmsgs on q */ 

ushort m sg__qbyt e s ; /* max number of bytes on q */ 

ushort msg__lspid; /* pid of last m sg snd operation */ 

ushort msg___lrpid; /* pid of last m sgr cv operation */ 

time__^t msg__stime; /* last m sg snd time * / 

time__t msgrtime; /*last m sgr c v time * / 
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time_t msg__ctime; /* last change time */ 

/* Times measured in secs since */ 
/« 00:00:00 GMT, Jan. 1, 1970 */ 

Msg^perm is an ipc perm structure that specifies the message 
operation permission (see below). This structure includes 
thefollowingmembers: 


u s h 0 r t 

c ui d ; 

/« 

creator 

user id */ 

u s h 0 r t 

cgid ; 

/« 

creator 

group id */ 

ushor t 

uid ; 

/* 

user id 

*/ 

us hor t 

gid ; 

/» 

group id 

*/ 

u s h 0 r t 

mode; 

/* 

r/w permission */ 


Msg qnum is the number of messages currently on the queue, 
Msg gbytes is the maximum number of bytes allowed on the 
queue. Msg Ispi d is the process id of the last process that 
performed a m sg snd operation (see msgop ( 2 ) ) . Msg Irpid is 
the process id of the last process that performed a m sgr cv 
operation (see msgop ( 2 ) ) . Msg stime is the time of the last 
msg snd operation, msg rtime is the time of the last m s g r c v 
operation, and msg c t ime is the time of the last msgctl ( 2 ) 
operation that changed a member of the above structure. 

Message Operation Permissions. 

In the msgop ( 2 ) and msgctl (2) system call descriptions, the 
permission required for an operation is given as { to ken } , 
where k£ n is the type of permission needed, interpreted as 
fol lows : 

00400 Read by user 

00200 Write by user 

00060 Read, Write by group 

00006 Read, Write by others 

Read and Write permissions on a msqid are granted to a pro- 
cess if one or more of the following are true: 

The process’s effective user ID is superuser. 

The process’s effective user ID matches msg perm . [ c ] ui d 
in the data structure associated with msqid and the 
appropriate bit of the ''user’’ portion (0600) of 
msg perm . mode is set. 

The process’s effective user ID does not match 
msg perm .[c3 uid , the process’s effective group ID 
matches msg perm . [ c] gid , and the appropriate bit of the 
''group’”* ^rtion To'STiT of msg perm . mode is set. 

The process’s effective user ID does not match 
msg per m . [ c ] ui d , the process’s effective group ID does 
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not match msg per m.[c]gid, and the appropriate bit of 
the ''other’’ portion (06) of m sg perm . mod e is set. 

Otherwise, the corresponding permissions are denied. 


Semaphore Identifier 

A semaphore identifier (semid) is a unique positive integer 
created by a sem g e t ( 2 ) system call. Each semid has a set of 
semaphores and a data structure associated with it. The 
data structure is referred to as semid d s and contains the 
following members: 


struct 

i pc__ 

perm* sem perm; 

/» 

operation permission struct */ 

ushort 

sem 

nsems; 

/« 

number of sems in set •/ 

ti me__ 

t 

sem__ 

otime ; 

/» 

last operation time */ 

time 

t 

sem 

ctime; 

/» 

last change time */ 





/* 

Times measured in secs since * 





/» 

00:00:00 GMT, Jan. 1, 1970 */ 


Sem___^perm is an ipc^^perm structure that specifies the sema- 
phore operation permission (see below). This structure 
includes the following members: 


ushort 

c u i d ; 

ushort 

cgid ; 

ushort 

ui d ; 

ushort 

gid ; 

ushort 

mode; 


/* creator user id */ 
/* creator group id »/ 
/* user id */ 

/• group id 

/• r/a permission •/ 


The value of sem nsems is equal to the number of semaphores 
in the set. Each semaphore in the set is referenced by a 
positive integer referred to as a sem num . Sem num values 

run sequentially from 0 to the value of sem nsems minus 1, 

Sem otime is the time of the last semop ( 2 ) operation, and 
sem ctime is the time of the last sem c 1 1 (2) operation that 
changed a member of the above structure. 


A semaphore is a data structure that contains the following 
members: 

ushort semval; /* semaphore value */ 

short sempid; /* pid of last operation */ 

ushort semncnt; /* # awaiting semval > cval */ 

ushort semzcnt; /* # awaiting semval = 0 */ 

Semval is a non-negative integer, Sempid is equal to the 

process ID of the last process that performed a semaphore 
operation on this semaphore. Semncnt is a count of the 

number of processes that are currently suspended until this 
semaphore’s semval becomes greater than its current value, 
Se mzcnt is a count of the number of processes that are 

currently suspended until this semaphore’s semval becomes 
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zero. 

Semaphore Operation Permissions. 

Tn the semo p ( 2 ) and seme tl ( 2 ) system call descriptions, the 
permission required for an operation is given as { t o ken } , 
where toke n is the type of permission needed, interpreted as 
fol lows : 

OOMOO Pead by user 

00200 Alter by user 

00060 Read, Alter by group 

00006 Pead, Alter by others 

Pead and Alter permissions on a semid are granted to a pro- 
cess if one or more of the following are true; 

The process's effective user ID is superuser. 

The process's effective user ID matches sem perm . [ c ] ui d 
in the data structure associated with semid and the 
appropriate bit of the ''user'' portion (0600) of 
sem perm , mode is set. 

The process's effective user ID does not match 

sem perm . [ c 3 ui d , the process's effective group ID 
matches sem perm . [ c] gid , and the appropriate bit of the 
''group'' portion (060) of sem perm . mode is set. 

The process's effective user ID does not match 

sem perm .[c]uid, the process's effectivegroup ID does 
not match sem perm .[ c] gid , and the appropriate bit of 

the ''other'' portion (06) of sem perm . mode is set. 

Otherwise, the corresponding permissions are denied. 

Shared Memory Identifier 

A shared memory identifier (shmid) is a unique positive 
integer created by a shmget (2) system call. Each shmid has 
a segment of memory (referred to as a shared memory segment) 
and a data structure associated with it. The data structure 
is referred to as shmid d s and contains the following 
members: 

struct 
in t 

ushor t 
u s h o r t 
short 
t i m e__ t 
t i m e__ t 
time t 
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ipc__perm shm^perm; /* operation permission struct */ 
shm__segsz; /* size of segment */ 

shm_cpid; /* creator pid */ 

shm^lpid; /* pid of last operation */ 

shm_nattch; /* number of current attaches */ 

shm_atime; /* last attach time */ 

shm_^dtime; /* last detach time •/ 

shm__ctime; /* last change time */ 

/• Times measured in secs since */ 
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/» 00:00:00 GMT, Jan. 1, 1970 */ 

Shm___perm is an ipo__perm structure that specifies the shared 
memory operation permission (see below). This structure 
includes the following members: 


u s h 0 r t 

c ui d ; 

/» 

creator user id */ 

us hor t 

cgid ; 

/» 

creator group id */ 

u s h 0 r t 

ui d ; 

/* 

user id •/ 

ushor t 

; 

/* 

group id */ 

u s h 0 r t 

mode; 

/* 

r/w permission */ 


Shm segsz specifies the size of the shared memory segment, 
S h m. c p i d is the process id of the process that created the 
shared memory identifier, Shm. Ipid is the process id of the 
last process that performed a shmop ( 2 ) operation, 
Shm nattch is the number of processes that currently have 
this segment attached, Shm atime is the time of the last 
shmat operation and shm dtim e is the time of the last shmd t 
operation; see shm o p ( 2 ) . Shm ctime is the time of the last 
shmc tl ( 2 ) operation that changed one of the members of the 
above structure. 

Shared Memory Operation Permissions. 

In the shmop ( 2 ) and shmctl (2) system call descriptions, the 
permission required for an operation is given as { to ken } , 
where token is the type of permission needed, interpreted as 
follows : 

00400 Peadbyuser 

00200 Write by user 

00060 Read, Write by group 

00006 Read, Write by others 

Read and Write permissions on a shm id are granted to a pro- 
cess if one or more of the following are true: 

The process’s effective user ID is superuser. 

The process’s effective user ID matches shm_^perm . [ c ] ui d 
in the data structure associated with shm id and the 
appropriate bit of the ''user’’ portion (0600) of 
shm perm . n^£|[e is set. 

The process’s effective user ID does not match 

shm perm . [ c ] ui d , the process’s effective group ID 
matches shm perm . [ c 3 gid , and the appropriate bit of the 
''group’’ portion (060) of shm perm . mode is set. 

The process’s effective user ID does not match 

shm perm . [ c] uid , , the process’s effective group ID does 

not match shm perm . [ c] gid , and the appropriate bit of 
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the ''other’’ portion (06) of shm perm . i s 

Otherwise, the corresponding permissions are denied 

SEE ALSO 

introC 3 ) . 


set. 
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NAME 

access - determine accessibility of a file 
SYNOPSIS 

int access (path, am ode) 
char * pa t h ; 
int a mode; 

DESCRIPTION 

Path points to a pathname naming a file. Access checks the 
named file for accessibility according to the bit pattern 
contained in amode, using the real user ID in place of the 
effective user ID and the real group ID in place of the 
effective group ID. The bit pattern contained in amode is 
constructed as follows; 

04 read 
02 write 

01 execute (search) 

00 check existence of file 

Access to the file is denied if one or more of the following 
a r e t r u e ; 

A component of the path prefix is not a directory. 
[ENOTDIR] 

Read, write, or execute (search) permission is 
requested for a null pathname. [ENOENT] 

The named file does not exist. [ENOENT] 

Search permission is denied on a component of the path 
prefix. [EACCES] 

Write access is requested for a file on a read-^only 
file system. [EROFS] 

Write access is requested for a pure procedure (shared 
text) file that is being executed. [ETXTBSY] 

Permission bits of the file mode do not permit the 
requested access. [EACCES] 

Path points outside the process’s allocated address 
space. [EFAULT] 

The owner of a file has permission checked with respect to 
the ''owner’’ read, write, and execute mode bits; members of 
the file's group other than the owner have permissions 
checked with respect to the ''group’’ mode bits; all others 
have permissions checked with respect to the ''other’’ mode 
bits. 


- 1 ^ 


Printed 6 1985 



ACCESS(2) 


ACCESS(2) 


RETURN VALUE ' 

Tf therequested access is permitted, a value 
returned. Otherwise, a value of -1 is returned and 
set to indicate the error. 


SEE ALSO 

chmod(?), state?). 


of 0 is 
err no is 
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NAME 

acct - enable or disable process accounting 

SYNOPSIS 

int acct (path) 
c h a r * p a t h. ; 

DESCRIPTION 

Acct is used to enable or disable the system’s process 
accounting routine. If the routine is enabled, an account- 
ing record is written on an accounting file for each process 
that terminates. Termination can be caused by one of two 
things: an exit call or a signal; see ex i t ( ? ) and signal (2) . 
The effective user ID of the calling process must be 
superuser to use this call. 

Path points to a pathname naming the accounting file. The 
accounting file format is given in ac c t ( M ) . 

The accounting routine is enabled if path is non-zero and no 
errors occur during the system call. It is disabled if path 
is zero and no errors occur during the system call. 

Acct fails if one or more of the following are true; 

The effective user ID of the calling process is not 
superuser. [EPEPM] 

An attempt is made to enable accounting when it is 
already enabled. [EBUSY] 

A component of the path prefix is not a directory. 
[ ENOTDIP ] 

One or more components of the accounting file's path- 
name do not exist. [ENOENT] 

A component of the path prefix denies search permis- 
sion. [ EACCES ] 

The file named by path is not an ordinary file, 
[EACCES] 

Mode permission is denied for the named accounting 
file. [EACCES] 

The named file is a directory, [EISDIR] 

The named file resides on a read-only file system. 
[EROFS] 

Path points to an illegal address. [EFAULT] 
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RETURN VALUE 

Upon successful completion, a value of 0 is returned. Other- 
wise, a value of -1 is returned and er r no is set to indicate 
the error. 


SEE ALSO 

a c c t ( 4 ) . 


2 


Printed 6 1985 



ALAFM(2) 


ALAfM(l) 


NAME 

alarm - set a process's alarm clock 
SYNOPSIS 

unsigned alarm (sec) 
un si gned sec ; 

DESCRIPTION 

Alarm instructs the calling process’s alarm clock to send 
the signal SIGALRM to the calling process after the number 
of real time seconds specified by sec have elapsed; see sig- 
na l ( 2 ) . 

Alarm requests are not stacked; successive calls reset the 
calling process's alarm clock. 

If sec is 0, any previously made alarm request is canceled. 
RETURN VALUE 

A larm returns the amount of time previously remaining in the 
calling process's alarm clock. 

SEE ALSO 

pause(?), signal(2). 
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NAME 

brk, sbrk - change data segment space allocation 

SYNOPSIS 

int brk (endds) 
char * end d s ; 

char*sbrk(incr) 
int i nc r ; 

DESCRIPTION 

Br k and sbrk are used to change dynamically the amount of 
space allocated for the calling process’s data segment; see 
e X ec ( ? ) . The change is made by resetting the process’s 
break value and allocating the appropriate amount of space. 
The break value is the address of the first location beyond 
the end of the data segment. The amount of allocated space 
increases as the break value increases. The newly allocated 
space is set to zero. 

B r k sets the break value to e ndds and changes the allocated 
space accordingly. 

Sbrk adds incr bytes to the break value and changes the 
allocated space accordingly. Incr can be negative, in which 
case the amount of allocated space is decreased. 

Brk and s brk fail without making any change in the allocated 
space if one or more of the following are true: 

The requested change would result in more space being 
allocated than is allowed by a system-imposed maximum 
(see ulimi t (?) ) . [ENOMEM] 

The requested change would result in the break value 
being greater than or equal to the start address of any 
attached shared memory segment (see shmo p ( 2 ) ) . 

RETURN VALUE 

Upon successful completion, brk returns a value of 0 and 
sbrk returns the old break value. Otherwise, a value of -1 
is returned and err no is set to indicate the error. 

SEE ALSO 

ex ec ( 2 ) . 
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NAME 

chdlr - change working directory 

SYNOPSIS 

in t chd ir (path) 
char*path; 

DESCRIPTION 

Pat h points to the pathname of a directory. Chdir causes 
the named directory to become the current working directory. 
The starting point for path searches for pathnames that do 
not begin with /. 

Chdir fails and the current working directory remains 
unchanged if one or more of the following are true: 

A component of the pathname is not a directory. 
[ENOTDTP] 

The named directory does not exist. [ENOENT] 

Search permission is denied for any component of the 
pathname. [EACCES] 

Path points outside the process's allocated address 
space. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Oth- 
erwise, a value of -1 is returned and err no is set to indi- 
cate the error. 

SEE ALSO 

c hr oo t ( ? ) . 
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NAME 

chmofi - change mode of file 
SYNOPSIS 

intchmod (path, mode) 
char *path; 
i n t mode; 

DESCRIPTION 

Path points to a pathname naming a file, Chmod sets the 
access permission portion of the named file's mode according 
to the bit pattern contained in mode . 

Access permission bits are interpreted as follows: 

OMOOO Set user ID on execution. 

02000 Set group ID on execution. 

01000 Save text image after execution. 

00400 Read by owner, 

00200 Write by owner, 

OOTOO Execute (or search if a directory) by owner. 
00070 Read, write, execute (search) by group. 

00007 Read, write, execute (search) by others. 

The effective user ID of the process must match the owner of 
the file or be superuser to change the mode of a file. 

If the effective user ID of the process is not superuser, 
mode bit 01000 (save text image on execution) is cleared. 

If the effective user ID of the process is not superuser or 
the effective group ID of the process does not match the 
group ID of the file, mode bit 02000 (set group ID on execu- 
tion)iscleared. 

If an executable file is prepared for sharing, mode bit 
01000 prevents the system from abandoning the swap-space 
image of the program -text portion of the file when its last 
user terminates. Thus, when the next user of the file exe- 
cutes it, the text need not be read from the file system but 
can simply be swapped in, saving time. 

Chmod fails and the file mode remains unchanged if one or 
more of the following are true: 

A component of the path prefix is not a directory. 
[ENOTDIR] 

The named file does not exist. [ENOENT] 

Search permission is denied on a component of the path 
prefix. [EACCES] 
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The effective user ID hoes not match the owner of the 
file anh the effective user ID is not superuser. 
[ E P E P M ] 

The named file resides on a read^-only file system.. 
[ EPOFS] 

points outside the process’s allocated address 
space. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Oth- 
erwise, a value of -1 is returned and er r no is set to indi- 
cate the error. 

SEE ALSO 

chown(2), mknod(2). 
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NAME 

chown - change owner and group of a file 
SYNOPSIS 

int chown (path, owner, group) 

char *path; 

int owner , group; 

DESCRIPTION 

Path points to a pathname naming a file. The owner ID and 
group ID of the named file are set to the numeric values 
contained in owner and group respectively. 

Only processes with the effective user ID equal to the file 
owner or superuser may change the ownership of a file, 

I f c ho wn is invoked by other than the superuser, the set- 
user-ID and set-group-ID bits of the file mode are cleared 
(bits OMOOO and 02000, respectively). See chmod ( 2 ) for a 
complete list of access permission bits. 

Cho w n fails and the owner and group of the named file remain 
unchanged if one or more of the following are true: 

A component of the path prefix is not a directory. 
[ ENOTDIR ] 

The named file does not exist. [ENOENT] 

Search permission is denied on a component of the path 
prefix. [ EACCES ] 

The effective user ID does not match the owner of the 
file and the effective user ID is not superuser. 
[ EPERM ] 

The named file resides on a read-only file system. 
[EROFS] 

Path points outside the process's allocated address 
space. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Oth- 
erwise, a value of -1 is returned and err no is set to indi- 
cate the error. 

SEE ALSO 

chmod ( 2 ) . 
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NAME 

chroot - change root HI rectory 
SYNOPSIS 

in t c hroo t (path) 
char *path; 

DESCRIPTION 

Path points to a pathname naming a Hirectory. Chr oo t causes 
the named directory to become the root directory. The 
starting point for path searches for pathnames that begin 
with / . 

The effective user ID of the process must be superuser to 
change the root directory. 

The ,, entry in the root directory is interpreted to mean 
the root directory itself. Thus, ,, cannot be used to 
access files outside the subtree rooted at the root direc- 
tory. 


Chr o o t fails and the root directory remains unchanged if one 
or more of the following are true: 

Any component of the pathname is not a directory. 
[ENOTDIP] 

The named directory does not exist. [ENOENT] 

The effective user ID is not superuser. [EPERM] 

Path points outside the process’s allocated address 
space. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Oth- 
erwise, a value of -1 is returned and err no is set to indi- 
cate the error. 

SEE ALSO 

c h d i r ( 2 ) . 
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NAME 

close - close a file descriptor 
SYNOPSIS 

in t close ( f i Id es) 
int fildes; 

DESCRIPTION 

Filde s is a file descriptor obtained from a c r ea t ( P ) , 
open ( P ) . dup ( P ) , f on tl ( P ) , or pi pe ( p ) system call. Clos e 
closes the^file descriptor indicated by fildes . 

Close fails if fil des is not a valid open file descriptor. 
[EBADF] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Oth- 
erwise, a value of -1 is returned and er r no is set to indi- 
cate the error. 

SEE ALSO 

creat(p), dup(P), exec(P), fcntl(P), open(P), pipe(P). 
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NAME 

Great - create a new file or rewrite an existing one 
SYNOPSIS 

int creat (path, mode) 
char *path ; 
int mode; 

DESCRIPTION 

Creat creates a new ordinary file or prepares to rewrite an 
existing file named by the pathname pointed to by path . 

If the file exists, the length is truncated to 0 and the 
mode and owner are unchanged. Otherwise, the file's owner 
ID is set to the process's effective user ID, the file's 
group ID is set to the process's effective group ID, and the 
low-order 1? bits of the file mode are set to the value of 
mod e , modified as follows: 

All bits set in the process's file mode creation mask 
are cleared; see urn ask ( ? ) . 


Mode bit 01000 (save text image after execution) is 
cleared; see c hmod ( 2 ) . 

Upon successful completion, a non-negative integer, namely 
the file descriptor, is returned and the file is open for 
writing, even if the mode does not permit writing. The file 
pointer is set to the beginning of the file. The file 
descriptor is set to remain open across exec system calls; 
see f c n 1 1 ( 2 ) . No process may have more than 20 files open 
simultaneously. A new file may be created with a mode that 
forbids writing. 

Creat fails if one or more of the following are true; 

A component of the path prefix is not a directory, 
[ ENOTDTP ] 

A component of the path prefix does not exist, 
[ ENOENT] 

Search permission is denied on a component of the path 
prefix . [EACCES] 

The pathname is null. [ENOENT] 

The file does not exist and the directory in which the 
file is to be created does not permit writing. 
[EACCES] 

The named file resides or would reside on a read-only 
file system. [EROFS] 
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The file is a pure procedure (shared text) file that is 
being executed. [ETXTBSY] 

The file exists and write permission is denied. 
[EACCES] 

The named file is an existing directory. [EISDTP] 

Twenty (20) file descriptors are currently open. 
[EMFTLE] 

Path points outside the process’s allocated address 
space. [EFAULT] 

RETURN VALUE 

Upon successful completion, a non-negative integer (i.e., 
the file descriptor) is returned. Otherwise, a value of -1 
is returned and err no is set to indicate the error. 

SEE ALSO 

close(2), dup(2), lseek(2), open(2), read(2), umask(2), 
wr i t e ( 2 ) . 
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NAME 

dup - duplicate an open file descriptor 

SYNOPSIS 

intdup(fildes) 
int fildes; 

DESCRIPTION 

Filde s is a file descriptor obtained from a c r e a t ( 2 ) , 
open ( 2 ) , £jjp ( 2 ) , f c n 1 1 ( 2 ) , or pi pe (2) system call. Dup 
returns a new file descriptor having the following in common 
with the original: 

Same open file (or pipe). 

Same file pointer (i.e., both file descriptors share 
one file pointer). 

Same access mode (read, write, or read/write). 

The new file descriptor is set to remain open across exec(2) 
system calls; see f cnt 1 ( 2 ) , 

The file descriptor returned is the lowest one available. 

Du p fails if one or more of the following are true: 

Fildes is not a valid open file descriptor. [EBADF] 

Twenty (20) file descriptors are currently open. 
[EMFTLE] 

RETURN VALUE 

Upon successful completion a non-negative integer (i.e., the 
file descriptor) is returned. Otherwise, a value of -1 is 
returned and er r no is set to indicate the error. 

SEE ALSO 

creat(2), close(2), exec(2), fcntl(2), open(2), pipe(2). 
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NAME 

execl, execv, execle, execve, execlp, execvp - execute a 
file 

SYNOPSIS 

int execl (path, argO, arg1, argn, 0) 

char *path, *argO, »arg1, *argn; 

int execv (path, argv) 
char *path, *argv[ ]; 

int execle (path, argO, argi, argn, 0, envp) 

char •path, •argO, •argi, ..., •argn, •envp[ ]; 

int execve (path, argv, envp) 
char •path, •argvC ], •envp C ]; 

int execlp (file, argO, argi, argn, 0) 

char •file, •argO, •argi, •argn; 

int execvp (file, argv) 
char •file, »argv[]; 

DESCRIPTION 

Exec in all its forms transforms the calling process into a 
new process. The new process is constructed from an ordi- 
nary, executable file called the new process This 

file consists of a header (see a . o ut ( M ) ) , a text segment, 
and a data segment. The data segment contains an initial- 
ized portion and an uninitialized portion (bss). There can 
be no return from a successful exec because the calling pro- 
cess is overlaid by the new process. 

When a C program is executed, it is called as follows: 

main ( ar g c , argv , envp ) 
int ar gc ; 

char •• argv , •• envp ; 

where ar gc is the argument count and argv is an array of 
character pointers to the arguments themselves. As indi- 
cated, ar g G is conventionally at least one and the first 
member of the array points to a string containing the name 
of the file. 

Path points to a pathname that identifies the new process 
file. 

File points to the new process file. The path prefix for 
this file is obtained by a search of the directories passed 
as the environmen t line "PATH =" (see environ (5 ) ) « The 
environment is supplied by the shell (see sh(1)). 
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A r g 0 , .... ar g n are pointers to nul 1- terminated char- 

acter strings. These strings constitute the argument list 
available to the new process. By convention, at least a r g 0 
must be present and point to a string that is the same as 
path (or its last component), 

A r g V is an array of character pointers to null-terminated 
strings. These strings constitute the argument list avail- 
able to the new process. By convention, ar g v must have at 
least one member, and it must point to a string that is the 
same as path (or its last component), Ar g v is terminated by 
a null pointer, 

En V p is an array of character pointers to null-terminated 
strings. These strings constitute the environment for the 
new process, En v p is terminated by a null pointer. For 
ex ec 1 and ex ecv , the C run-time start- off routine places a 
pointer to the calling process’s environment in the global 
cell extern char **environ;. This pointer is used to pass 
the calling process’s environment to the new process. 

File descriptors open in the calling process remain open in 
the new process, except for those whose close- on -exec flag 
is set; see f cn tl ( 2 ) , For those file descriptors that 
remain open, the file pointer is unchanged. 

Signals set to terminate the calling process are set to ter- 
minate the new process. Signals set to be ignored by the 
calling process are set to be ignored by the new process. 
Signals set to be caught by the calling process are set to 
terminate the new process; see signal ( 2 ) , 

If the set-user-ID mode bit of the new process file is set 
(see c hm o d ( 2 ) ) , e xec sets the effective user ID of the new 
process to the owner ID of the new process file. Similarly, 
if the set-group-ID mode bit of the new process file is set, 

the effective group ID of the new process is set to the 

group ID of the new process file. The real user ID and real 

group ID of the new process remain the same as those of the 

calling process. 

The shared memory segments attached to the calling process 
are not attached to the new process (see shmop ( 2 ) ) , 

Profiling is disabled for the new process; see pro f i 1 ( 2 ) , 

The new process also inherits the following attributes from 
the calling process; 

nice value (see n i c e ( 2 ) ) 
process ID 
parent process ID 
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process group TD 

semadj values (see s e m o p ( 2 ) ) 

tty group TD (see ex 1 1 ( 2 ) and s i g n a 1 ( 2 ) ) 

trace flag (see ptrace(2) request 0) 

time left until an alarm clock signal (see al ar m ( 2 ) ) 
current working directory 
root directory 

file mode creation mask (see urn as k ( 2 ) ) 
file size lim.it (see ulimit (2) ) 

ut i me , s t i m e , c ut ime , and o s t im e (see times ( 2 ) ) 

Exec fails and returns to the calling process if one or more 
of the following are true: 

One or more components of the new process file’s path- 
name do not exist, [ENOENT] 

A component of the new process file’s path prefix is 
not a directory. [ENOTDIR] 

Search permission is denied for a directory listed in 
the new process file’s path prefix. [EACCES] 

The new process file is not an ordinary file. [EACCES] 

The new process file mode denies execution permission, 
[EACCES] 

The exec is not an ex ec 1 p or ex ec v p , and the new pro- 
cess file has the appropriate access permission but an 
invalid magic number in its header, [ENOEXEC] 

The new process file is a pure procedure (shared text) 
file that is currently open for writing by some pro- 
cess. [ETXTBSY] 

The new process requires more memory than is allowed by 
the system-imposed maximum MAXMEM. [ENOMEM] 

The number of bytes in the new process’s argument list 
is greater than the system- imposed limit of 5,120 
bytes. [E2BIG] 

The new process file is not as long as indicated by the 
size values in its header. [EFAULT] 

Path, argv, or envp points to an illegal address. 
[EFAULT] 

RETURN VALUE 

If exec returns to the calling process an error has 
occurred; the return value is -1 and err no is set to 
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NAME 

exit, __exit - terminate process 
SYNOPSIS 

void exit (status) 
int status; 
void __exit (status) 
int status; 

DESCRIPTION 

Exit terminates the calling process with the following 
consequences: 

All the file descriptors open in the calling process 
areclosed. 

If the parent process of the calling process is execut- 
ing a wait , it is notified of the calling process’s 
termination and the low-order 8 bits (i.e,, bits 0377 ) 
of statu s are made available to it; see wa i t ( 2 ) . 

If the parent process of the calling process is not 
executing a wait , the calling process is transformed 
into a zombie process. A zombie pro c ess is a process 
that only occupies a slot in the process table; it has 
no other space allocated either in user or kernel 
space. The process table slot that it occupies is par- 
tially overlaid with time accounting information (see 
< sys/ proc , h> ) to be used by times . 

The parent process ID of all of the calling process’s 
existing child processes and zombie processes is set 
to 1. This means the initialization process (see 
in tro ( 2 ) ) inherits each of these processes. 

Each attached shared memory segment is detached and the 
value of shm nattach in the data structure associated 
with its shared memory identifier is decremented by 1; 
see shmop ( 2 ) . 

For each semaphore for which the calling process has 
set a semaphore adjustment (semadj) value (see 
semo p ( 2 ) ) , that semadj value is added to the sem v al of 
the specified semaphore. 

If the process has a process, text, or data lock, an 
unlock is performed (see ploc k ( 2 ) ) . 

An accounting record is written on the accounting file 
if the system’s accounting routine is enabled; see 
_ac £_t ( 2 ) . 

If the process ID, tty group ID, and process group ID 
of the calling process are equal, the SIGHUP signal is 
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sent to each process that has a process group ID equal 
to that of the calling process. 

The C function exit may cause cleanup actions before the 
process exits. The function exit circumvents all cleanup. 

SEE ALSO 

acct(2), plock(2), semop(2), shmop(2), signal(2), times(2), 
wa i t ( 2 ) . 

WARNING 

See WANING in signal ( 2 ) . 
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NAME 

fcntl - file control 
SYNOPSIS 

linclude <fcntl.h> 

int fcntl (fildes, cmd, arg) 
int fildes, cmd, arg; 

DESCRIPTION 

Fcntl provides control over open files, Fildes is an open 
file descriptor obtained from a c r ea t ( 2 ) , ope n ( 2 ) , d up ( 2 ) , 
fcntl ( 2 ) , or _p^ P£ (2) system call. 

The cm d s available are: 

F__DUPFD Return a new file descriptor as follows: 

Lowest numbered available file descriptor greater 
than or equal to ar g . 

Same open file (or pipe) as the original file. 

Same file pointer as the original file (i.e,, both 
file descriptors share one file pointer). 

Same access mode (read, write, or read/write) . 

Same file status flags (i.e,, both file descrip- 
tors share the same file status flags). 

The close-on-exec flag associated with the new 
file descriptor is set to remain open across 
ex ec ( 2 ) system calls. 

F__GETFD Get the close-on-exec flag associated with the 
file descriptor f i Id es . If the low-border bit is 
0, the file remains open across exec; otherwise 
the file is closed upon execution of exec . 

F__SETFD Set the close-on-exec flag associated with fildes 
to the low-order bit of arg (0 or 1 as above) . 

F__GETFL Get file status flags. 

F__SETFL Set file status flags to arg . Only certain flags 
can be set; see f cntl ( 5 ) » 

Fcntl fails if one or more of the following are true: 

Fi Id es is not a valid open file descriptor. [EBADF] 

Cmd is F___DUPFD and 20 file descriptors are currently 
open. [EMFILE] 
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Cm ci is F__DUPFD and ar g is negative or greater than ?0, 
[ eTn VAL ] 

Refer to f cn 1 1 (5) for a list of the flag values contained in 
< f cntl . h> . 

RETURN VALUE 

Upon successful completion, the value returned depends on 
cmd as foil ows : 

F__DUPFD A new file descriptor. 

F__GETFD Value of flag (only the low-order bit is 
defined) , 

F__SETFD Value other than -1. 

F_GETFL Value of file flags. 

F__SETFL Value other than -1. 

Otherwise, a value of -1 is returned and err no is set to 
indicate the error. 

SEE ALSO 

close(2), exec(2), open(2), fcntl(5). 
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NAME 

fork - create a new process 

SYNOPSIS 

i n t fork ( ) 

DESCPIPTION 

Fork causes creation of a new process. The new process 
(child process) is an exact copy of the calling process 
(parent process). This means the child process inherits the 
following attributes from the parent process: 

environment 

close-on-exec flag (see ex ec ( 2 ) ) 

-- signal handling settings (i.e., SIG_DFL, SIG__IGN , 
function address) 
set-user-ID mode bit 
-- set-group-ID mode bit 
« — profiling on/off status 

-- nice value (see nic e ( 2 ) ) 

-- all attached shared memory segments (see shmo p ( 2 ) ) 

• -- process group ID 

-- tty group ID (see ex i t ( 2 ) and si gn al ( 2 ) ) 

-- trace flag (see ptr ac e ( 2 ) request 0) 

-- time left until an alarm clock signal (see 
alarm ( 2 ) ) 

current working directory 
-- root directory 

-- file mode creation mask (see urn ask ( 2 ) ) 

-- file size limit (see ul im i t ( 2T) 

The child process differs from the parent process in the 
fol lowing ways : 

The child process has a unique process ID. 

The child process has a different parent process ID 
(i.e., the process ID of the parent process). 

The child process has its own copy of the parent's file 
descriptors. Each of the child's file descriptors 
shares a common file pointer with the corresponding 
file descriptor of the parent. 

All semadj values are cleared (see 3emop ( 2 ) ) . 

Process locks, text locks, and data locks are not 
inherited by the child (see plock (2) ) . 

The child process's ut ime , stime , cut ime , and cs t im e 
are set to 0. 

Fork fails and no child process is created if one or more of 
the following are true; 
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The sy s t em- im po sed limit on the total number of 

processes under execution would be exceeded. [EAGATN] 

The sys t em- i mpo sed limit on the total number of 

processes under execution by a single user would be 
exceeded. [EAGAIN] 

RETURN VALUE 

Upon successful completion, fork returns a value of 0 to the 
child process and returns the process ID of the child pro- 
cess to the parent process. Otherwise, a value of -1 is 
returned to the parent process, no child process is created, 
and er r no is set to indicate the error. 

SEE ALSO 

exec(2), times(2), wait(2). 
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NAME 

getpid, getpgrp, getppid ^ get process, process group, and 
parent process IDs 


SYNOPSIS 

int getpid () 

int getpgrp () 

int getppid () 


DESCRIPTION 

Getpid returns the process ID of the calling process. 

Get p grp returns the process group ID of the calling process. 

Ge t ppi d returns the parent process ID of the calling pro- 
cess. 


SEE ALSO 

exec(?), fork(P), intro(2), setpgrp(2), signal(2). 
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NAME 

getuid, geteuid, get g id, getegid - get real user, effective 
user, real group, and effective group IDs 

SYNOPSIS 

int getuid () 

int geteuid () 

int getgid () 

int getegid () 


DESCRIPTION 

Getui d returns the real user ID of the calling process. 

Geteuid returns the effective user ID of the calling pro- 
cess. 

Getgid returns the real group ID of the calling process. 

Ge teg id returns the effective group ID of the calling pro- 
cess. 


SEE ALSO 

intro(2), setuid(2). 
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NAME 

ioctl - control device 
SYNOPSIS 

ioctl (fildes, request, arg) 

DESCRIPTION 

_^£_t 1. performs a variety of functions on character special 
files (devices). The descriptions of various devices in 
Section 7 of the Administrator ’ s Manual discuss how ioctl 
appliestothem. 

Ioctl fails if one or more of the following are true: 

Fildes is not a valid open file descriptor. [EBADF] 

^ l_d_£S is not associated with a character special dev- 
ice. [ENOTTY] 

Request or arg is not valid. See Section 7. [EINVAL] 
RETURN VALUE 

If an error has occurred, a value of -1 is returned and 
err no is set to indicate the error. 

SEE ALSO 

termio(7) in the Administrator’s Manual. 
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NAME 

kill - send a signal to a process or a group of processes 
SYNOPSIS 

in t ki 1 1 ( pi d , si g ) 
int pid, sig; 

DESCRIPTION 

Kil l sends a signal to the process or group of processes 
specified by pid . The signal that is to be sent is speci- 
fied by sig and is either one from the list given in sig- 
nal (?) or 0 . If sig is 0 (the null signal), error checking 
is performed but no signal is actually sent. This can be 
used to check the validity of pid . 

The real or effective user ID of the sending process must 
match the real or effective user ID of the receiving process 
unless the effective user ID of the sending process is 
superuser . 

The processes with a process ID of 0 and a process ID of 1 
are special processes (see intro (2) ) and are referenced 
below as proc 0 and proc 1 , respectively. 

If ^d is greater than zero, sig is sent to the process 
whose process ID is equal to pi d . Pid may equal 1. 

sig is sent to all processes, excluding pr oc 0 
and proc 1 , whose process group ID is equal to the process 
group ID of the sender. 

If pi d is -1 and the effective user ID of the sender is not 
superuser, sig is sent to all processes, excluding proc 0 and 
proc 1 , whose real user ID is equal to the effective user ID 
of the sender. 

I f pid is -1 and the effective user ID of the sender is 
superuser, sig is sent to all processes, excluding proc 0 and 
pr oc 1 . 

If pid is negative but not -1, sig is sent to all processes 
whose process group ID is equal to the absolute value of 
pid . 

Kill fails and no signal is sent if one or more of the fol- 
lowing are true: 

Si g is not a valid signal number, [EINVAL] 

No process can be found corresponding to that specified 
by pi d . [ ESRCH] 

The user ID of the sending process is not superuser, 
and its real or effective user ID does not match the 


^ 1 


Printed 6 1985 



KILL(2) 


KILL(2) 


real or effective user ID of the receiving process. 
[EPEPM] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Oth- 
erwise, a value of -1 is returned and err no is set to indi- 
cate the error. 

SEE ALSO 

kill(l), getpid(P), setpgrp(2), signal(2). 
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NAME 

link - link to a file 
SYNOPSIS 

intlink(path1,path2) 
char •path"', *path2; 

DESCRIPTION 

Pa t h 1 points to a pathname naming an existing file, P a t h 2 
points to a pathname naming the new directory entry to be 
created. Link creates a new link (directory entry) for the 
existing file. 

Link fails and no link is created if one or more of the fol- 
lowing are true: 

A component of either path prefix is not a directory, 
[ ENOTDTF ] 

A component of either path prefix does not exist. 

[ENOENT] 

A component of either path prefix denies search permis- 
sion. [EACCES] 

The file named by path! does not exist. [ENOENT] 

The link named by p a t h 2 exists. [EEXIST] 

The file named by p a t h i is a directory and the effec- 

tive user ID is not superuser. [EPERM] 

The link named by pa t h2 and the file named by p a t h 1 are 
on different logical devices (file systems), ITXDEV] 

P a t h 2 points to a null pathname. [ENOENT] 

The requested link requires writing in a directory with 
a mode that denies write permission, [EACCES] 

The requested 1 i n k* r equ i r e s writing in a directory on a 
read-only file system. [EROFS] 

Path points outside the process’s allocated address 
space. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Oth- 
erwise, a value of -1 is returned and err no is set to indi- 
catetheerror. 

SEE ALSO 

uni ink( 2 ) . 
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NAME 

Iseek - move reari/write file pointer 
SYNOPSIS 

long Iseek (fildes, offset, whence) 
int fildes; 
long offset; 
int whence; 

DESCRIPTION 

Fildes is a file descriptor returned from a c r e a t ( 2 ) , 
o_p^ ( 2 ) , ^ p ( 2 ) , or f cntl (2) system call, Iseek sets the 

file pointer associated with fildes as follows: 


If 

whence is 

0, 

the 

pointer 

i s 

se t 

to 

offset bytes. 

If 

wh en c e is 

1 , 

the 

pointer 

i s 

set 

to 

its 

current loca- 


t i o n plus 

offset. 






If 

whence is 

2, 

the 

po in ter 

i s 

se t 

to 

the 

size of the 


file plus 

offset. 







Upon successful completion, the resulting pointer location 
as measured in bytes from the beginning of the file is 
returned , 

L 3 e e k fails and the file pointer remains unchanged if one or 
more of the following are true; 

Fildes is not an open file descriptor. [EBADF] 

Filde s is associated with a pipe or f i fo . [ESPIPE] 

Whence is not 0, i, or 2. [EINVAL and SIGSYS signal] 

The resulting file pointer would be negative. [EINVAL] 

Some devices are incapable of seeking. The value of the 
file pointer associated with such a device is undefined, 

RETURN VALUE 

Upon successful completion, a non-negative integer indicat- 
ing the file pointer value is returned. Otherwise, a value 
of -1 is returned and err no is set to indicate the error. 

SEE ALSO 

creat(2), dup(2), fcntl(2), open(2). 
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NAME 

mknod - make a Hirectory* or a special or ordinary file 
SYNOPSIS 

int mknod (path, mode, dev) 
char •path; 
int mod e , dev; 

DESCRIPTION 

Mknod creates a new file named by the pathname pointed to by 
path . The mode of the new file is initialized from mod e , 
where the value of mode is interpreted as follows; 

0170000 file type; one of the following; 

0010000 fifo special 
OOPOOOO character special 
0040000 directory 
0060000 block special 
0100000 or 0000000 ordinary file 
0004000 set user ID on execution 
0002000 set group ID on execution 
0001000 save text image after execution 

0000777 access permissions; constructed from the fol- 
lowing : 

0000400 read by owner 
0000200 write by owner 

0000100 execute (search on directory) by owner 
0000070 read, write, execute (search) by group 
0000007 read, write, execute (search) by others 

The file’s owner ID is set to the process’s effective user 
ID. The file’s group ID is set to the process’s effective 
group ID. 

Values of m.od e other than those above are undefined and 
should not be used. The low-order 9 bits of mode are modi- 
fied by the process’s file mode creation mask; all bits set 
in the process’s file mode creation mask are cleared (see 
urn a sk ( 2 ) ) . If mod e indicates a block or character special 
file, dev is a configuration-dependent specification of a 
character or block I/O device. If mod e does not indicate a 
block special or character special device, dev is ignored. 

Mknod may be invoked only by the superuser for file types 
other than FIFO special. 

Mknod fails and the new file is not created if one or more 
of the following are true: 

The process’s effective user ID is not superuser, 
[EPERM] 

A component of the path prefix is not a directory. 
[ENOTDIR ] 
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A component of the path prefix does not exist. 
[ENOENT] 

The directory in which the file is to be created is 
located on a read-only file system. [EROFS] 

The named file exists. [EEXIST] 

Path points outside the process's allocated address 
space. [EFAULT] 

RETURN VALUE 

Upon successful completion a value of 0 is returned. Other- 
wise, a value of -1 is returned and err no is set to indicate 
t h e e r r o r . 

SEE ALSO 

mkdir(l), chmod(?), exec(2), umask(2), fs(M). 
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NAME 

mount - mount a file system 
SYNOPSIS 

int mount (spec, fiir, rwflag) 
char *spec, •dir; 
int rwflag; 

DESCRIPTION 

Moun_t requests that a removable file system contained on the 
block special file identified by spec be mounted on the 
directory identified by dir . Spec and dir are pointers to 
pa thn ame s . 

Upon successful completion, references to the file dir refer 
to the root directory on the mounted file system. 

The low-order bit of rwflag is used to control write permis- 
sion on the mounted file system. If the low-order bit is 1, 
writing is forbidden; otherwise writing is permitted accord- 
ing to individual file accessibility. 

Mo un t may be invoked only by the superuser. 

Mo un t fails if one or more of the following are true: 

The effective user ID is not superuser. [EPEPM] 

Any of the named files does not exist. [ENOENT] 

A component of a path prefix is not a directory. 
[ ENOTDIP ] 

Spec is not a block special device. [ENOTBLK] 

The device associated with spec does not exist. 
[ ENXIO] 

Dir is not a directory. [ENOTDIP] 


Spec or dir points outside the process’s allocated 
address space. [EFAULT] 

Pi r is currently mounted on, is someone’s current work- 
ing directory, or is otherwise busy. [EBUSY] 

The device associated with spec is currently mounted, 
[EBUSY] 

RETURN VALUE 

Upon successful completion a value of 0 is returned. Other- 
wise, a value of -1 is returned and er r no is set to indicate 
the error. 
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NAME 

msgctl - message control operations 


SYNOPSIS 

linclude < sys/ 1 ype s .h> 
^include <sys/ipc.h> 

^include <sys/msg.h> 

int msgctl (msqid, cmd, buf) 
int msqid, cmd; 
struct msqid ds *buf; 


DESCRIPTION 

Msgctl provides a variety of message control operations as 
specified by cmd . The following cmd s are available: 

IPC_^STAT Place the current value of each member of the 
data structure associated with msqid into the 
structure pointed to by buf . The contents of 
this structure are defined in intro(2). {READ} 


IPC__SET Set the value of the following members of the 
data structure associated with msqid to the 
corresponding value found in the structure 
pointed to by buf : 
m sg^perm . ui d 
m sg__pe rm . g id 

m sg__pe rm .mod e /* only low 9 bits •/ 
msg^qbytes 

This cmd can only be executed by a process that 
has an effective user ID equal to either that of 
superuser or to the value of m sg per m . ui d in the 
data structure associated with msqid . Only 
superuser can raise the value of m sg gbytes . 

IPC__RMID Remove the message queue identifier specified by 
msqid from the system and destroy the message 
queue and data structure associated with it. 
This cmd can only be executed by a process that 
has an effective user ID equal to either that of 
superuser or to the value of m sg per m . ui d in the 
data structure associated with msqid . 

Msgctl fails if one or more of the following are true*. 

Msqid is not a valid message queue identifier. 

[EINVAL] 


Cmd is not a valid command. [EINVAL] 

Cmd is equal to IPC STAT and {READ} operation permis- 
sion is denied to"“the calling process (see in tro ( 2 ) ) . 
[EACCES] 
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Cm d is equal to IPC^PMID or IPC__SET and the effective 
user ID of the calling process is not equal to that of 
superuser and is not equal to the value of m s g p e r m . u i d 
in the data structure associated with m sqi d . [EPEPM] 

Cmd is equal to IPC_^SET, an attempt is being made to 
increase to the value of msg qbytes , and the effective 
user ID of the calling process is not equal to that of 
superuser. [EPEPM] 

Buf points to an illegal address. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Other- 
wise, a value of -1 is returned and err no is set to indicate 
the err or . 

SEE ALSO 

m sgg e t ( ? ) , m sgop ( 2 ) . 
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NAME 

msgget - get message queue 

SYNOPSIS 

linclude < sys/ type s .h> 

^include <sys/ipc.h> 

//include <sys/msg.h> 

int msgget (key, msgflg) 
key^t key; 
in t^m sg f Ig ; 

DESCRIPTION 

Msgget returns the message queue identifier associated with 
ke y . 

A message queue identifier and associated message queue and 
data structure (see in tr o ( 2 ) ) are created for ke y if one of 
the following is true: 

Key is equal to IPC^PFIVATE. 

Key does not already have a message queue identifier 
associated with it, and ( msg fig & IPC__CREAT) is 
''true’’. 

Upon creation, the data structure associated with the new 
message queue identifier is initialized as follows; 


Msg perm . G ui d , msg perm . uid , msg perm . cgid , and 

msg perm . g id are set equal to the effective user ID and 
effective group ID, respectively, of the calling pro- 
cess. 

The low-order 9 bits of msg perm . mode are set equal to 
the low- order 9 bits of msgflg . 

Msg qn urn , msg 1 spi d , msg Irpi d , msg stime , and 

msg r time are set equal to 0. 

Msg ctime is set equal to the current time. 

Ms g qbyt es is set equal to the system limit. 


Msgget fails if one or more of the following are true: 

A message queue identifier exists for key but operation 
permission (see intro ( 2 ) ) , as speci fied by the low- 
order 9 bits of msgflg , would not be granted. [EACCES] 

A message queue identifier does not exist for key and 
( msgflg & IPC GREAT) is "false’’. [ENOENT] 
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A message queue identifier is to be created but the 
system imposed limit on the maximum number of allowed 
m.essage queue identifiers system wide would be 
exceeded. [ENOSPC] 

A message queue identifier exists for key but ( ( msg f 1 g 
& TPC GREAT) & ( msgflg & IPC EXCL) ) is "true’’. 
[EEXTST] 

RETURN VALUE 

Upon successful completion, a non-negative integer (i.e,, a 
message queue identifier) is returned. Otherwise, a value 
of -1 is returned and errno is set to indicate the error. 

SEE ALSO 

msgctlC?), msgopC?). 
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NAME 

msgsn<i, msgrcv - message operations 

SYNOPSIS 

#include<sys/types.h> 

^include <sys/ipc,h> 
j^include <sys/insg.h> 

int msgsnd (msqid, msgp, msgsz, msgflg) 
in t m sqi d ; 

struct msgbuf *msgp; 
int msgsz , msg fig ; 

int msgrcv (msqid, msgp, msgsz, msgtyp, msgflg) 
int msqid; 

struct msgbuf *msgp; 
intmsgsz; 
long msgtyp; 
int msgflg; 

DESCRIPTION 

Msgsnd is used to send a message to the queue associated 
with the message queue identifier specified by msqid , {WRITE} 
Msgp points to a structure containing the message. This 
structure is composed of the following members; 

long mtype; /* message type */ 

char mtext[]; /* message text */ 

Mtype is a positive integer that can be used by the receiv- 
ing process for message selection (see msgrc v below), M t e x t 
is any text of length msgsz bytes. Msgsz can range from. 0 
to a system impos.ed maximum. 

Msgflg specifies the action to be taken if one or more of 
the following are true; 

The number of bytes already on the queue is equal to 
msg q byte s (see in tro ( 2 ) ) . 

The total number of messages on all queues system-wide 
is equal to the system imposed limit. 

These actions are as follows; 

If ( msgflg & IPC___NOWAIT ) is ''true’’, the message is 
not sent and the calling process returns immediately. 

C msg fig & IPC^NOWAIT) is ''false’’, the calling pro- 
cess suspends execution until one of the following 
occurs; 
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The condition responsible for the suspension no 
longer exists, in which case the message is 
sent. 

Msqid is removed from the system (see 
m sg c 1 1 ( 2 ) ) . When this occurs, er rn o is set 
equal to EIDRM and a value of -1 is returned. 

The calling process receives a signal that is 
to be caught. In this case the message is not 
sent and the calling process resumes execution 
in the manner prescribed in si gnal ( 2 ) ) . 

Msg snd fails and no message is sent if one or more of the 
following are true: 

Msqid is not a valid message queue identifier. 

[EINVAL] 

Operation permission is denied to the calling process 
(see intro ( 2 ) ) . [EACCES] 

Mt ype is less than 1. [EINVAL] 

The message cannot be sent for one of the reasons cited 
above and ( msgflg & IPC_NOWAIT) is "true’’. [EAGAIN] 

Msg s z is less than zero or greater than the system 
imposed limit. [EINVAL] 

M sg p points to an illegal address. [EFAULT] 

Upon successful completion, the following actions are taken 
with respect to the data structure associated with msqid 
(see intro ( 2 ) ) . 

Msg qnum is incremented by 1, 

Msg Ispid is set equal to the process ID of the calling 
process , 

Msg stime is set equal to the current time. 

M s g r c V reads a message from the queue associated with the 
message queue identifier specified by msqid and places it in 
the structure pointed to by msgp . {READ} This structure is 
composed of the following members; 

long mtype; /* message type */ 

char mtext[]; /♦ message text */ 

Mt y pe is the received message’s type, as specified by the 
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sending process, Mt e x t is the text of the message, Ms g s z 
specifies the size in bytes of m te x t , The received message 
is truncated to m s g s z bytes if it is larger than m sg s z and 
( msg fig & MSG__NOERROR ) is ''true’’. The truncated part of 
the message is lost and no indication of the truncation is 
given to the calling process, 

M s g t y p specifies the type of message requested as follows: 

If m sg ty p is equal to 0, the first message on the queue 
is received, 

T f m sg t y p is greater than 0, the first message of type 
m s g t y p is received, 

I f msgty p isless than 0, the first message of the 
lowest type that is less than or equal to the absolute 
value of P is received, 

M s g f 1 g specifies the action to be taken if a message of the 
desired type is not on the queue. These are as follows: 

( tnsg f Ig & IPC^NOWAIT) is ''true*' , the calling pro- 
cess returns immediately with a return value of -1 and 
err no set to ENOMSG. 

If ( msg fig & IPC^NOWAIT) is ''false’’, the calling pro- 
cess suspends execution until one of the following 
occurs : 

A message of the desired type is placed on the 
queue. 

Ns qi d is removed from the system. When this 
occurs, er r no is set equal to EIDRM, and a 
value of -1 is returned. 

The calling process receives a signal that is 
to be caught. In this case a message is not 
received and the calling process resumes execu- 
tion in the manner prescribed in .si gnal ( 2 ) ) , 

Msgr c V fails and no message is received if one or more of 
the following are true; 

Ms qi d is not a valid message queue identifier. 
[EINVAL ] 

Operation permission is denied to the calling process, 
[ EACCES] 

Msg sz is less than 0, [EINVAL] 
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M_text is greater than msg sz and ( msg f Ig & MSG NOERROF) 
i s“*^fal se ’ » . [E2BIG] 

The queue does not contain a message of the desired 
type and ( msgtyp & IPC_NOWAIT) is "true’’. [ENOMSG] 

Ms g p points to an illegal address. [EFAULT] 

Upon successful completion, the following actions are taken 
with respect to the data structure associated with m sqi d 
(see intro ( 2 ) ) . 

Msg qnum is decremented by 1, 

Msg Irpid is set equal to the process ID of the calling 
process . 

Msg rtime is set equal to the current time, 

RETURN VALUES 

sg snd or m sgr c V returns due to the receipt of a signal, 
a value of -1 is returned to the calling process and err no 
is set to EINTR, If they return due to removal of m sqi d 
from the system, a value of -1 is returned and err no is set 
to EIDRM. 

Upon successful completion, the return value is as follows: 
Msg snd returnsavalueofO, 

Msgrc V returns a value equal to the number of bytes 
actually placed into m tex t . 

Otherwise, a value of -1 is returned and err no is set to 
indicate the error, 

SEE ALSO 

msgctl(2), msgget(2). 
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NAME 

nice - change priority of a process 

SYNOPSIS 

int nice (incr) 
i n t i n c r ; 

DESCRIPTION 

Nice adds the value of incr to the nice value of the calling 
process. A process’s nice value is a positive number for 
which a more positive value results in lower CPU priority. 

A maximum nice value of 39 and a minimum nice value of 0 are 
imposed by the system. Requests for values above or below 
these limits result in the nice value being set to the 
corresponding limit. 

Nice fails and does not change the nice value if incr i s 
negative and the effective user ID of the calling process is 
not superuser. [EPERM] 

RETURN VALUE 

Upon successful completion, nice returns the new nice value 
minus 20. Otherwise, a value of -1 is returned and err no is 
set to indicate the error, 

SEE ALSO 

nice(1), exec(?). 
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NAME 

onyx - Onyx 6810 special system service 
SYNOPSIS 

linclude <onyx.h> 

int onyx (request, argi, arg2) 

int request, arg2; 

char » ar g 1 ; 

DESCRIPTION 

on yx is used to provide some special operating system ser- 
vices for the ONYX 6810 system. Currently, the request argu- 
ment can be one of the following: 

0NYX__C0NF The ar g2 is ignored by this call and 

the system configuration information 
is stored into argi . 

0NYX_^UCP With this request 3K bytes of informa- 

tion are copied into argi . First, IK 
bytes of the user stack are copied, 
followed by the user area of the the 
process . 

ar g2 specifies the table entry in the 
proc table for the process desired. 

onyx will fail and not perform the requested operation if 
one or more of the following are true: 

There is not enough memory allocated for the informa- 
tion to be copied. [EFAULT] 

Request code is invalid, [EINVAL] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned to the 
calling process. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 
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NAME 

open - open for reading or writing 
SYNOPSIS 

finclude <fcntl.h> 

int open (path, oflag, [mode] ) 

char *path; 

int oflag, mode; 

DESCRIPTION 

Path points to a pathname naming a file. Open opens a file 
descriptor for the named file and sets the file status flags 
according to the value of oflag . Oflag values are con- 
structed by or-ing flags from the following list (only one 
of the first three flags below may be used): 

0__RD0NLY Open for reading only, 

O^WRONLY Open for writing only. 

0__^RDWR Open for reading and writing, 

0_NDELAY This flag may affect subsequent reads and writes. 
See r e ad ( 2 ) and wr i t e ( 2 ) . 

When opening a FIFO with 0_RD0NLY or 0_WR0NLY set: 
If 0_NDELAY is set: 

An open for reading-only returns without 
delay. An open for writing-only returns an 
error if no process currently has the file 
open for reading. 

If 0_NDELAY is clear: 

An open for reading-only blocks until a pro- 
cess opens the file for writing. An open for 

writing-only blocks until a process opens the 
file for reading. 

When opening a file associated with a communication 
line: 

If 0_NDELAY is set: 

The open returns without waiting for carrier. 

If 0__NDELAY is clear: 

The open blocks until carrier is present. 

0__APPEND If set, the file pointer is set to the end of the 
file prior to each write. 
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0__CBEAT If the file exists, this flag has no effect. Oth- 
erwise, the file's owner ID is set to the process's 
effective user ID, the file's group ID is set . to 
the process's effective group ID, and the low-order 
12 bits of the file mode are set to the value of 
mode modified as follows (see c r e at ( 2 ) ) : 

All bits set in the process's file mode crea- 
tion mask are cleared. See urn a sk ( 2 ) . 

Mode bit 01000 (save text image after execu- 
tion) is cleared. See chmod(2). 


0__^TPUNC If the file exists, its length is truncated to 0 
and the mode and owner are unchanged. 


O^EXCL If 0__EXCL and 0__CREAT are set, open fails if the 
file exists. 


Upon successful completion a non-negative integer, the file 
descriptor, is returned. 

The file pointer used to mark the current position within 
the file is set to the beginning of the file. 

The new file descriptor is set to remain open across exec 
system calls. See f cn tl ( 2 ) . 

No process may have more than 20 file descriptors open 
simultaneously. 

The named file is opened unless one or more of the following 
a r e t r u e : 

A component of the path prefix is not a directory, 
[ENOTDIP ] 

O^CPEAT is not set and the named file does not exist. 
[ENOENT] 

A component of the path prefix denies search permis- 
sion. [EACCES] 

Of 1 ag permission is denied for the named file, 
[ EACCES ] 

The named file is a directory and oflag is write or 
read/write. [EISDTR] 

The named file resides on a read-only file system and 
oflag is write or read/write. [EROFS] 

20 file descriptors are currently open. [EMFTLE] 
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The named file is a character special or block special 
file, and the device associated with this special file 
does not exist. [ENXTO] 

The file is a pure procedure (shared text) file that is 
being executed and o f 1 ag is write or read/ write. 
[ ETXTBSY] 

Path points outside the process’s allocated address 
space. CEFAULT] 

0__CPEAT and 0__EXCL are set and the named file exists. 
[ EEXIST] 

0__NDELAY is set, the named file is a FIFO, 0__WP0NLY is 
set, and no process has the file open for reading. 
[ENXTO] 

RETURN VALUE 

Upon successful completion, a non-negative integer (i.e., a 
file descriptor) is returned; otherwise, a value of -1 is 
returned and er r no is set to indicate the error. 

Refer to fcntl ( 5 ) for a list of the flag values contained in 
< f cntl . h> . 

SEE ALSO 

close(2), creat(2), dup(2), fcntl(2), lseek(2), read(2), 
write(2), fcntl(5). 
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NAME 

pause - suspend process until signal 

SYNOPSIS 

pa use ( ) 


DESCRIPTION 

Pause suspends the calling process until it receives a sig-- 
nal . The signal must be one that is not currently set to be 
ignored by the calling process. 

If the signal causes termination of the calling process, 
paus e does not return. 

If the signal is caught by the calling process and control 
is returned from the signal-^catching function (see sig- 
nal ( P ) ) , the calling process resumes execution from the 
point of suspension. A value of -1 is returned from pause 
and err no is set to EINTR. 

SEE ALSO 

alarm(2), kill(?), signal(2), wait(2). 
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NAME 

pipe - create an interprocess channel 
SYNOPSIS 

in t pi pe ( f i 1 d e s) 
int fildes[2]; 

DESCRIPTION 

Pipe creates an I/O mechanism called a pipe and returns two 
file descriptors, fildes LO] and f i Id es [ 1 3 . Fildes LO] is 
opened for reading and fi ldes [ 1 ] is opened for writing. 

Writes up to 5,120 bytes of data are buffered by the pipe 
before the writing process is blocked. A read on file 
descriptor fi lde sLO] accesses the data written to fildes Li] 
on a f i r St- in- fi r St-out basis. 

No process may have more than 20 file descriptors open 
simultaneously. 

Pipe fails if 19 or more file descriptors are currently 
open. [EMFILE] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Oth- 
erwise, a value of -1 is returned and er r no is set to indi- 
cate the error. 

SEE ALSO 

sh(1), read(?), write(2). 
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NAME 

plock - lock process, text, or data in memory 
SYNOPSIS 

linclude <sys/lock.h> 

int plock (op) 
in t op; 

DESCRIPTION 

Ploc k allows the calling process to lock its text segment 
(text lock), its data segment (data lock), or both its text 
and data segments (process lock) into memory. Locked seg- 
ments are immune to all routine swapping, Plock also allows 
these segments to be unlocked. The effective user ID of the 
calling process must be superuser to use this call. jlP 
specifies the following; 

PFOCLOCK lock text & data segments into memory 

(process lock) 

TXTLOCK lock text segment into memory (text 

lock) 

DATLOCK lock data segment into memory (data 

lock) 

UNLOCK remove locks 

Plock fails and does not perform the requested operation if 
one or more of the following are true: 

The effective user ID of the calling process is not 
superuser. [EPERM] 

Op is equal to PROCLOCK and a process lock, a text 
lock, or a data lock already exists on the calling pro- 
cess. [EINVAL] 

Op is equal to TXTLOCK and a text lock or a process 

lock already exists on the calling process, [EINVAL] 

Op is equal to DATLOCK and a data lock or a process 

lock already exists on the calling process. [EINVAL] 

Op is equal to UNLOCK and no type of lock exists on the 
calling process. [EINVAL] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned to the 
calling process. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 
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NAME 

profil - execution time profile 

SYNOPSIS 

void profil (buff, bufsiz, offset, scale) 
char •buff; 

int bufsiz, offset, scale; 

DESCRIPTION 

Buff points to an area of core whose length (in bytes) is 
given by b u f s i z . After this call, the user’s program 
counter (pc) is examined each clock tick (60th second); 
off set is subtracted from it and the result is multiplied by 
scal e. If the resulting number corresponds to a word inside 
buff , that word is incremented. 

The scale is interpreted as an unsigned, fixed^point frac- 
tion with binary point at the left; 0177777 (octal) gives a 
1-1 mapping of pc’s to words in buff ; 077777 (octal) maps 

each pair of instruction words together. 02(8) maps all 
instructions onto the beginning of buff (producing a non- 
interrupting core clock). 

Profiling is turned off by giving a scale ofOorl. It is 
rendered ineffective by giving a bufsiz of 0. Profiling is 
turned off when an exec is executed, but remains on in child 
and parent both after a for k . Profiling is turned off if an 
update in buff would cause a memory fault, 

RETURN VALUE 

Not defined . 

SEE ALSO 

prof(1), monitor(3C). 
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NAME 

ptrace - process trace 

SYNOPSIS 

int ptrace (request, pi<i, addr, data); 
int request, pid, addr, data; 

DESCRIPTION 

Ptr ac e provides a means by which a parent process may con-^ 
trol the execution of a child process. Its primary use is 
for the implementation of breakpoint debugging; see sd b ( 1 ) . 
The child process behaves normally until it encounters a 
signal (see si gnal ( 2 ) for a list of signals), at which time 
it enters a stopped state and its parent is notified via 
wa i t ( 2 ) . When the child is in the stopped state, its parent 
can examine and modify its ''core image’’ using ptrace . The 
parent also can cause the child either to terminate or con- 
tinue, with the possibility of ignoring the signal that 
caused it to stop. 

The reques t argument determines the precise action to be 
taken by ptrac e and is one of the following: 

0 This request must be issued by the child process 
if it is to be traced by its parent. It turns on 
the child’s trace flag that stipulates that the 
child should be left in a stopped state upon 
receipt of a signal rather than the state speci- 
fied by the f unc argument of si gnal ( 2 ) . The pi d ^ 
_^dr, and ££ta arguments are ignored and a return 
vaTue is n^ defined for this request. Peculiar 
results ensue if the parent does not expect to 
trace the child. 

The remainder of the requests can only be used by the parent 
process. For each, pid is the process ID of the child. The 

child must be in a stopped state before these requests are 

made. 

1, 2 With these requests, the word at location addr in 
the address space of the child is returned to the 
parent process. If I and D space are separated, 
request 1 returns a word from I space, and request 
2 returns a word from D space. If I and D space 
are not separated, either request 1 or request 2 
may be used with equal results. The data argument 
is ignored. These two requests fail if addr is 

not the start address of a word, in which case a 

value of -1 is returned to the parent process and 
the parent’s er rno is set to EIO. 

3 With this request, the word at location addr in 
the child’s USER area in the system’s address 
space (see < sys/ user , h> ) is returned to the parent 
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process. Addresses in this area range from 0 to 
102M on the PDP-lls and 0 to 2048 on the 3B20S, 
VAX, and M68000. The data argument is ignored. 
This request fails if ad d r is not the start 
address of a word or is outside the USER area, in 
which case a value of -1 is returned to the parent 
process and the parent’s err no is set to ETO. 

5 With these requests, the value given by the data 
argument is written into the address space of the 
child at location ad d r . If I and D space are 
separated, request ^ writes a word into I space 
and request 5 writes a word into D space. If I 
and D space are not separated, either request 4 or 
request 5 may be used with equal results. Upon 
successful completion, the value written into the 
address space of the child is returned to the 
parent. These two requests fail if ad d r is a 
location in a pure procedure space and another 
process is executing in that space, or if addr is 
not the start address of a word. Upon failure a 
value of -1 is returned to the parent process and 
the parent’s er r no is set to EIO. 

With this request, a few entries in the child’s 
USER area can be written. Data gives the value 
that is to be written and addr is the location of 
the entry. The few entries that can be written 
ar e ; 

the general registers (i.e., registers 0-11 
on the 3B20S, registers 0-7 on PDP-lls, and 
registers 0-15 on the VAX and M68000) 

certain bits of the Processor Status Word on 
the M68000 and M68010 (i.e., bits 0-4 and 15) 

the condition codes of the Processor Status 
Word on the 3B20S . 

the floating point status register and six 
floating point registers on PDP-lls 

certain bits of the Processor Status Word on 
PDP-lls (i.e, bits 0-4, and 8-11) 

certain bits of the Processor Status Longword 
on the VAX (i.e., bits 0-7, 16-20, and 

30-31 ) 

This request causes the child to resume execution. 
If the data argument is 0, all pending signals, 
including the one that caused the child to stop, 
are canceled before it resumes execution. If the 
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fi a t a argumerit is a valid signal number, the child 
resumes execution as if it had incurred that sig- 
nal; any other pending signals are canceled. The 
ad d r argument m.ust be equal to 1 for this request. 
Upon successful com. pletion, the value of data is 
returned to the parent. This request fails if 
data is not 0 or a valid signal number, in which 
case a value of -1 is returned to the parent pro- 
cess and the parent’s err no is set to EIO, 

8 This request causes the child to terminate with 
the same consequences as e_x ( 2 ) . 

9 This request sets the trace bit in the Processor 

Status Word of the child (i.e., bit M on PDP-1ls; 
bit 30 on the VAX; bit 15 on the M68000) and then 
executes the same steps as listed above for 
request 7. The trace bit causes an interrupt upon 
completion of one machine instruction. This 

effectively allows single stepping of the child. 
On the 3B20S there is no trace bit and this 
request returns an error. 

Note: the trace bit remains set after an interrupt 
on PDP-lls but is turned off after an interrupt on 
the VAX and M68000. 

To forestall possible fraud, pt r ac e inhibits the set-user-id 
facility on subsequent e x ec ( 2 ) calls. If a traced process 
calls exec , it stops before executing the first instruction 
of the new image showing signal SIGTRAP. 

GENERAL ERRORS 

P t r ac e in general fails if one or more of the following are 
true; 

Reques t is an illegal number. [EIO] 

Pi d identifies a child that does not exist or has not 

executed a pt r ac e with request 0. [ESRCH] 


SEE ALSO 

sdb(1), exec(2), signal(2) 


wa i t ( 2 ) . 
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NAME 

reaH - rea<i from file 
SYNOPSIS 

int read (fildes, buf, nbyte) 
in t fi Id es ; 
char * buf ; 
unsigned nbyte; 

DESCRIPTION 

Elides is a file descriptor obtained from a o r ea t , open , 
d up , fcntl , or pi pe system call. 

Read attempts to read nbyte bytes from the file associated 
with f i Id e s into the buffer pointed to by buf . 

On devices capable of seeking, the read starts at a position 
in the file given by the file pointer associated with 
fildes . Upon return from read , the file pointer is incre^r- 
mented by the number of bytes actually read. 

Devices that are incapable of seeking always read from the 
current position. The value of a file pointer associated 
with such a file is undefined. 

Upon successful completion, read returns the number of bytes 
actually read and placed in the buffer; this number may be 
less than nbyte if the file is associated with a communica- 
tion line (see ioc tl ( 2 ) and term io ( 7 ) ) t or if the number of 
bytes left in the file is less than nbyte bytes. A value of 
0 is returned when an end-of-file ha's been reached. 

When attempting to read from an empty pipe (or FIFO): 

If O^NDELAY is set, the read returns a 0, 

If 0__NDELAY is clear, the read blocks until data is 
written to the file or the file is no longer open for 
writing. 

When attempting to read a file associated with a tty that 
has no data currently available; 

If 0__NDELAY is set, the read returns a 0, 

If 0__NDELAY is clear, the read blocks until data 
becomes available. 

Read fails if one or more of the following are true; 

Fildes is not a valid file descriptor open for reading. 
[EBADF] 
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Bu f points outside the allocated address space, 
[EFAULT] 

RETURN VALUE 

Upon successful completion a non-negative integer is 
returned indicating the number of bytes actually read. Oth- 
erwise, a -1 is returned and err no is set to indicate the 
error . 

SEE ALSO 

creat(2), dup(?), fcntl(2), ioctl(2), open(2), pipe(2), ter- 
mio ( 7 ) . 
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NAME 

semctl - semaphore control operations 
SYNOPSIS 

linclude < sy s/ 1 y pe s .h> 
linclude <sys/ipc.h> 

^include <sys/sem.h> 

int semctl (semid, semnum , cmd, arg) 
int semid , cmd ; 
int semnum ; 
union semun { 

int V al ; 

struct semid__ds •buf; 

ushor t ar r ay [ ] ; 

} arg; 

DESCRIPTION 

Semctl provides a variety of semaphore control operations as 
specified by cmd . 

The following cmd s are executed with respect to the sema- 
phore specified by semid and sem num (see in tr o ( 2 ) for defin- 
itions of values and permissions): 

GETVAL Return the value of semval . { READ) 

SETVAL Set the value of semval to ar g . v al . { ALTER } 

When this cmd is successfully executed, the 
semadj value (see ex i t ( 2 ) ) corresponding to 
the specified semaphore in all processes is 
cleared . 

GETPID Return the value of sempid . {READ} 

GETNCNT Return the value of semnc nt . {READ} 

GETZCNT Return the value of semzcnt . (READ) 

The following cm d s return and set, respectively, every sem - 
val in the set of semaphores. 

GETALL Place semval s into array pointed to by 

ar g . ar r ay . {READ} 

SETALL Set semval s according to the array pointed 

to by arg . array . (ALTER) When this cmd is 
successfully executed, the semadj values 
corresponding to each specified semaphore in 
all processes are cleared. 

The following cmd s are also available; 
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IPC^STAT Place the current value of each member of 

the data structure associated with sem i d 
into the structure pointed to by ar g . b uf . 
The contents of this structure are defined 
i n intro (2) . {READ} 

IPC SET Set the value of the following members of 

the data structure associated with sem id to 
the corresponding value found in the struc- 
ture pointed to by ar g . buf : 
sem__perm .uid 
sem^perm.gid 

sem^perm .mod e /* only low 9 bits */ 

This cm_d can only be executed by a process 
that has an effective user ID equal to 
either that of superuser or to the value of 
sem perm . uid in the data structure associ- 
ated with sem id . 

IPC__BMID Remove the semaphore identifier specified by 
sem i d from the system and destroy the set of 
semaphores and data structure associated 
with it. This cm d can only be executed by a 
process that has an effective user ID equal 
to either that of superuser or to the value 
o f sem perm . uid in the data structure asso- 
ciated with sem 1 d . 

Sem c 1 1 fails if one or more of the following are true: 

Semid is not a valid semaphore identifier, 
[ETNVAL] 

Semnum is less than zero or greater than 
sem nsem s . [EINVAL] 

Cmd is not a valid command. [EINVAL] 

Operation permission is denied to the calling pro- 
cess (see intro ( 2 ) ) . [EACCES] 

Cmd is SETVAL or SETALL and the value to which 
sem V al is to be set is greater than the system 
imposed maximum, [ERANGE] 

Cmd is equal to IPC__RMID or IPC_^SET and the effec- 
tive user ID of the calling process is not equal 
to that of superuser and is not equal to the value 
of sem perm . uid in the data structure associated 
with semid . [EPERM] 

Ar g .buf points to an illegal address. [EFAULT] 
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RETURN VALUE 

Upon successful completion, the value returnefi depends 
cm d as follows : 


The value of semval. 


The value of sem pi d . 
The value of semncnt 


GETVAL 
GETPID 

GETNCNT 

GETZCNT The value of semzcn t 

All others A value of 0. 

When seme tl is unsuccessful, a value of ■ 
errno is set to indicate the error. 


is returned 


on 


and 


SEE ALSO 

semget(2), semop(2), intro(2), exit(2). 
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NAME 

semget - get set of semaphores 

SYNOPSIS 

linclude < sys/ type s .h> 

^include <sys/ipc.h> 
i?include <sys/sem.h> 

int semget (key, nsems, semflg) 

key__t key; 

int nsems , semflg ; 

DESCRIPTION 

Semget returns the semaphore identifier associated with ke y . 

A semaphore identifier and associated data structure and set 
containing nsems semaphores (see in tr o ( 2 ) ) are created for 
key if one of the following is true: 

Key is equal to IPC PRIVATE. 


Key does not already have a semaphore identifier asso- 
ciated with it, and ( semflg & IPC_^CREAT) is ''true’’. 

Upon creation, the data structure associated with the new 
semaphore identifier is initialized as follows: 

Sem perm . cjui. £ , sem perm . u i d , sem perm , ££_ij2. » 3 ^ d 

sem perm . g id are set equal to the effective user ID and 
effective group ID, respectively, of the calling pro- 
cess. 

The low-order 9 bits of sem perm . mode are set equal to 
the low- order 9 bits of semflg . 

Sem nsems is set equal to the value of nsems. 


Sem otime is set equal to 0 and sem ctime is set equal 
to the current time, 

Semget fails if one or more of the following are true; 

Nsems is either less than or equal to zero or greater 
than the system imposed limit, [EINVAL] 

A semaphore identifier exists for ke y but operation 
permission (see in tro ( 2 ) ) , as specified by the low- 
order 9 bits of semflg , would not be granted, [EACCES] 

A semaphore identifier exists for key but the number of 
semaphores in the set associated with it is less than 
n sem s and nsems is not equal to zero. [EINVAL] 
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A semaphore identifier does not exist for ke y and 
(semflg & IPC_CPEAT) is "false’’. [ENOENT] 

A semaphore identifier is to be created but the system 
imposed limit on the maxim urn number of allowed sema- 
phores system wide would be exceeded, [ENOSPC] 

A semaphore identifier exists for ke y but ( ( semflg & 

TPC CFEAT) & ( semflg & IPC EXCL) ) is "true’’. 

[EEXIST] 

RETURN VALUE 

Upon successful completion, a non-negative integer (i.e., a 
semaphore identifier) is returned. Otherwise, a value of - 1 
is returned and err no is set to indicate the error. 

SEE ALSO 

semctl(2), semop(2). 
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NAME 

serrop - semaphore operations 

SYNOPSIS 

#include < sys/ type s ,h> 

^include <sys/ipc.h> 
j?include <sys/sein,h> 

int semop (semid, sops, nsops) 
int semid ; 

struct sembuf (*sops)[3; 
int nsops; 

DESCRIPTION 

Semop is used to atomically perform an array of semaphore 
operations on the set of semaphores associated with the 
semaphore identifier specified by semid , Sops is a pointer 
to the array of semaphore-operation structures, Nsops is 
the number of such structures in the array. Each structure 
includes the following members; 

short sem__num; /* semaphore number */ 

short sem__op; /* semaphore operation */ 

short sem__flg; /* operation flags */ 

Each semaphore operation specified by sem op is performed on 
the corresponding semaphore specified by semid and sem num , 

Sem op specifies one of three semaphore operations as fol- 
lows (see semaphore data structure in in tr o ( 2 ) ) : 

If sem op is a negative integer, one of the follow- 
ing occurs: {ALTER} 

I f sem V al is greater than or equal to the abso- 
lute value of sem op , the absolute value of 
sem op is subtracted from semv al , Also, if 
( sem fig & SEM__^UND0) is ''true’’, the absolute 
value of sem op is added to the calling 
process’s semadj value (see ex i t ( 2 ) ) for the 
specified semaphore. 

If semv al is less than the absolute value of 
sem op and ( sem fig & IPC__NOWAIT) is ''true’’, 
semop returns immediately. 

If semv al is less than the absolute value of 
sem op and ( sem fig & IPC_NOWAIT) is "false’’, 
semop increments the semncn t associated with 
the specified semaphore and suspends execution 
of the calling process until one of the follow- 
ing occurs; 
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Sem V al becomes greater than or equal to the 
absolute value of sem op . When this occurs, 
the value of semncnt associated with the 
specified semaphore is decremented, the 
absolute value of sem op is subtracted from 
sem V al and, if ( sem fig & SEM^UNDO) is 
''true’ ’ , the absolute value of sem op is 
added to the calling process's semadj value 
for the specified semaphore. 

The semid for which the calling process is 
awaiting action is removed from the system 
^ seme tl ( 2 ) ) . When this occurs, err no is 
set equal to EIDRM and a value of -1 is 
returned , 

The calling process receives a signal that 
is to be caught. When this occurs, the 
value of semncnt associated with the speci- 
fied semaphore is decremented and the cal- 
ling process resumes execution in the manner 
prescribed in si gn al ( 2 ) . 

If sem Ojp is a positive integer, the value of sem op 

is added to sem val and, if ( sem fig & SEM__UNDO) is 
''true'', the value of sem op is subtracted from the 
calling process's semadj value for the specified 
semaphore, {ALTER} 

Tf sem op is zero, one of the following occurs: 
{READ} 

s e m V a 1 is zero, s emop returns immediately. 

If semv al is not equal to zero and ( sem fig & 
IPC^NOWAIT) is ''true'', semop returns immedi- 
ateTy, 

If semv al is not equal to zero and ( sem fig & 
IPC__NOWAIT) is ''false'', semop increments the 
semzcnt associated with the specified semaphore 
and suspends execution of the calling process 
until one of the following occurs: 

Sem V al becomes zero, at which time the value 
of semzcnt associated with the specified 
semaphore is decremented. 

The semid for which the calling process is 
awaiting action is removed from the system. 
When this occurs, err no is set equal to 
EIDRM and a value of -1 is returned. 
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The calling process receives a signal that 
is to be caught. When this occurs, the 
value of semzcn t associated with the speci- 
fied semaphore is decremented and the cal- 
ling process resumes execution in the manner 
prescribed in si gnal ( 2 ) . 

Semo p fails if one or more of the following are true for any 
of the semaphore operations specified by sops ; 

Sem i d is not a valid semaphore identifier, [EINVAL] 

?em num is less than zero or greater than or equal to 
the number of semaphores in the set associated with 
sem i d , [ E F B I G ] 

Nso ps is greater than the system imposed maximum, 
[ E2BIG] 

Operation permission is denied to the calling process 
(see intro (2)), [EACCES] 

The operation would result in suspension of the calling 
process but ( sem fig & IPC NOWAIT) is ''true’’, 
[EAGAIN] 

The limit on the number of individual processes 
requesting a SEM^UNDO would be exceeded, [ENOSPC] 

The number of individual semaphores for which the cal- 
ling process requests a SEM UNDO would exceed the 
limit, [EINVAL] “ 

An operation would cause a sem v al to overflow the sys- 
tem imposed limit, [ERANGE] 

An operation would cause a semadj value to overflow the 
system imposed limit, [ERANGE] 

Sops points to an illegal address, [EFAULT] 

Upon successful completion, the value of sem pi d for each 
semaphore specified in the array pointed to by sops is set 
equal to the process ID of the calling process, 

RETURN VALUE 

If semop returns due to the receipt of a signal, a value of 
-1 is returned to the calling process and err no is set to 
EINTR, If it returns due to the removal of a sem id from the 
system, a value of -1 is returned and err no is set to EIDPM, 

Upon successful completion, the value of semv al at the time 
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of the call for the last operation in the array pointed to 
by sops is returned. Otherwise, a value of -1 is returned 
and e r r n o is set to indicate the error, 

SEE ALSO 

intro(?), exec(2), exit(2), forkC2), semctl(2), semget(2). 
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NAME 

setpgrp - set process group ID 

SYNOPSIS 

in t setpgrp ( ) 

DESCRIPTION 

Setp grp sets the process group ID of the calling process to 
the process ID of the calling process and returns the new 
process group ID. 

RETURN VALUE 

Setpgrp returns the value of the new process group ID. 

SEE ALSO 

exec(2), fork(2), getpid(2), intro(2), kill(2), signal(2). 
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NAME 

setuid, setgid - set user and group IDs 

SYNOPSIS 

int setuid ( uid ) 
in t uid; 

in t se tg i d ( g i d ) 
int gid ; 

DESCRIPTION 

Setuid (s etgid ) is used to set the real user (group) ID and 
effective user (group) ID of the calling process. 

If the effective user ID of the calling process is 
superuser, the real user (group) ID and effective user 
(group) ID are set to uid ( gid ) . 

If the effective user ID of the calling process is not 
superuser, but its real user (group) ID is equal to uid 
( gid ) , the effective user (group) ID is set to uid ( gid ) , 

Setuid (s etgid ) fails if the real user (group) ID of the 
calling process is not equal to uid ( gid ) and its effective 
user ID is not superuser. [EPEPM] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Oth- 
erwise, a value of -1 is returned and err no is set to indi- 
catetheerror. 

SEE ALSO 

ge tui d ( ? ) , in tro ( 2 ) . 
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NAME 

shmctl - shared memory control operations 
SYNOPSIS 

linclude <sys/types.h> 
j?include <sys/ipc.h> 
j?include <sys/shm.h> 

int shmctl (shmid, cmd, buf) 
int shmid, cmd; 
struct shmid^^ds *buf; 

DESCRIPTION 

Shmctl provides a variety of shared memory control opera- 
tions as specified by cmd . The following cm d s are ayail- 
ab 1 e : 

IPC__STAT Place the current value of each member of 

the data structure associated with shm id 
into the structure pointed to by buf . The 
contents of this structure are defined in 
i n tr o ( 2 ) . {READ} 

IPC SET Set the value of the following members of 

the data structure associated with shm id to 
^ the corresponding value found in the struc- 

ture pointed to by buf : 
shm__^perm . ui d 
shra__perm,gid 

shm__per m .mod e /* only low 9 bits •/ 

This cm d can only be executed by a process 
that has an effective user ID equal to 
either that of superuser or to the value of 
shm perm . uid in the data structure associ- 
ated with shm id . 

IPC^RMID Remove the shared memory identifier speci- 
fied by shmid from the system and destroy 
the shared memory segment and data structure 
associated with it. This cmd can only be 
executed by a process that has an effective 
user ID equal to either that of superuser or 
to the value of shm perm . uid in the data 
structure associated with shmid . 

Shmctl fails if one or more of the following are true: 

Sh mid is not a valid shared memory identifier. 
TeIN VAL ] 

J Cmd is not a valid command. [EINVAL] 
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Cm <i is equal to IPC__STAT and {READ} operation per- 
mission is denied to the calling process (see 
intro C 2 ) ) . [EACCES] 

Cmd is equal to IPC__RMID or IPC__SET and the effec- 
tive user ID of the calling process is not equal 
to that of superuser and is not equal to the value 
of shm perm.uid in the data structure associated 
with shmid . [EPEPM] 

Buf points to an illegal address, [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Other- 
wise, a value of -1 is returned and err no is set to indicate 
the error, 

SEE ALSO 

shmget(2), shmop(2). 
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NAME 

shmget - get shared memory segment 
SYNOPSIS 

#include < sys / t ype s .h> 

^include <sys/ipc.h> 
ifinclude <sys/shm.h> 

int shmget (key, size, shmflg) 

key__t key; 

int size, shmflg ; 

DESCRIPTION 

Shmget returns the shared memory identifier associated with 
ke y . 

A shared memory identifier and associated data structure and 
shared memory segment of size bytes (see intro (2)) are 
created for key if one of the following is true: 

Key is equal to I PC__P R I VATE . 

Kev does not already have a shared memory identifier 
associated with it, and ( shmflg & IPC__CREAT) is 
''true*’ . 

Upon creation, the data structure associated with the new 
shared memory identifier is initialized as follows: 

Shm per m . c ui d , shm perm . ul d , shm per m . eg id , and 

shm perm . gid are set equal to the effective user ID and 

effective group ID, respectively, of the calling pro*- 
cess . 

The low-order 9 bits of shm perm . mod e are set equal to 

the low-order 9 bits of shmflg . Shm segsz is set equal 

to the value of size . 

Shm 1 pi d , shm nattch , shm a t i roe , and shm dtime are set 
equal to 0 . 

Shm ctime is set equal to the current time, 

Shmg e t fails if one or more of the following are true: 

Size is less than the system imposed minimum or greater 
than the system imposed maximum, [EINVAL] 

A shared memory identifier exists for ke y but operation 
permission (see in tro ( 2 ) ) , as specified by the low- 
order 9 bits of shm fig , would not be granted. [EACCES] 

A shared memory identifier exists for ke y but the size 
of the segment associated with it is less than si ze and 


- 1 


Printed 6 1985 



SHMGET(2) 


SHMGET(2) 


size is not equal, to zero. [EINVAL] 

A shared memory identifier does not exist for key and 
( shmflg & IPC_CREAT) is ''false*'. [ENOENT] 

A shared memory identifier is to be created but the 
system imposed limit on the maximum number of allowed 
shared memory identifiers system-wide would be 
exceeded. [ENOSPC] 

A shared memory identifier and associated shared memory 
segment are to be created but the amount of available 
physical memory is not sufficient to fill the request. 
[ ENOMEM] 

A shared memory identifier exists for ke y but ( ( shm f Ig 

& IPC GREAT) & ( shmflg & IPG EXCL) ) is "true**. 

[EEXIST] 

RETURN VALUE 

Upon successful completion a non-negative integer, i.e., a 
shared memory identifier, is returned. Otherwise, a value 
of -1 is returned and er r no is set to indicate the error, 

SEE ALSO 

shmctl(2), shmop(2). 
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NAME 

shmat, shmdt - shared memory operations 

SYNOPSIS 

linclude < sys/ type s ,h> 

^include <sys/ipc.h> 

//include <sys/shm.h> 

char •shmat (shmid, shmaddr, shmflg) 
in t shm i d ; 
char •shmaddr 
int shmflg; 

int shmdt (shmaddr) 
char •shmaddr 

DESCRIPTION 

Shmat attaches the shared memory segment associated with the 
shared memory identifier specified by shmid to the data seg- 
ment of the calling process. The segment is attached at the 
address specified by one of the following criteria: 

If shmaddr is equal to zero, the segment is attached at 
the first available address as selected by the system, 

ad d r is not equal to zero and ( shmflg & SHM^RND) 

is true’’, the segment is attached at the address 

given by ( shm ad d r ( shm ad d r modulus SHMLBA)). 

If shm ad d r is not equal to zero and ( shm fig & SHM RND) 

is ' f a 1 se ’ ’ , the segment is attached at the adTiress 

given by shmaddr . 

The segment is attached for reading if ( shm fig & SHM___R DO NLY ) 
is ''true’’ {READ}; otherwise it is attached for read’ing and 
writing {READ/WRITE} . 

Shmat fails and does not attach the shared memory segment if 
one or more of the following are true: 

Shmid is not a valid shared memory identifier. 

Ieinval] 

Operation permission is denied to the calling process 
(see intro ( 2 ) ) . [EACCES] 

The available data space is not large enough to accom- 
modate the shared memory segment. [ENOMEM] 

Shm ad d r is not equal to zero, and the value of ( shm ad d r 
- ( shmadd r modulus SHMLBA)) is an illegal address. 

[EINVAL] 
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Shm ad d r is not equal to zero, ( shm fig & SHM^RND) is 
''false’’, and the value of shm ad d r is an illegal 
address. [ E IN VAL ] 

The number of shared memory segments attached to the 
calling process would exceed the system imposed limit. 
[EMFILE] 

Shmd t detaches from the calling process’s data segment the 
shared memory segment located at the address specified by 
shm ad d r . 

Shm. d t fails and does not detach the shared memory segment if 
shm ad d r is not the data segment start address of a shared 
memory segment. [EINVAL] 

RETURN VALUES 

Upon successful completion, the return value is as follows: 

Shm at returns the data segment start address of the 
attached shared memory segment. 

Shmd t returns a value of 0. 

Otherwise, a value of *-1 is returned and err no is set to 
indicate the error. 

SEE ALSO 

exec(2), exit(?), fork(2), shmctl(2), shmget(2). 
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NAME 

signal - specify what to <io upon receipt of a signal 
SYNOPSIS 

linclude < sys/ si gnal . h> 

int (^signal (sig, func))() 

in t si g ; 

int ( * f unc ) ( ) ; 

DESCRIPTION 

Signal allows the calling process to choose one of three 
ways in which it is possible to handle the receipt of a 
specific signal. Si g specifies the signal and f unc speci- 
fies the choice. 

Si g can be assigned any one of the following except SIGKILL: 


SIGHUP 

01 

hangup 

SIGINT 

02 

interrupt 

SIGQUIT 

03* 

quit 

SIGILL 

04* 

illegal instruction (not 

reset when caught) 

SIGTRAP 

05* 

trace trap (not reset when 
caught) 

SIGIOT 

06* 

lOT instruction 

SIGEMT 

07* 

EMT instruction 

SIGFPE 

08* 

floating point exception 

SIGKILL 

09 

kill (cannot be caught or 
i gnor ed ) 

SIGBUS 

10* 

bus error 

SIGSEGV 

1 1* 

segmentation violation 

SIGSYS 

12* 

bad argument to system call 

SIGPIPE 

13 

write on a pipe with no one 
to read it 

SIGALRM 

1 4 

alarm clock 

SIGTERM 

15 

software termination signal 

SIGUSR1 

16 

user defined signal 1 

SIGUSR2 

17 

user defined signal 2 

SIGCLD 

18 

death of a child (see WARN- 
ING below) 

SIGPWR 

19 

power fail (see WARNING 

below) 


See below for the significance of the asterisk (*) in the 
above list, 

Func is assigned one of three values: SIG^DFL, SIG^IGN, or a 
function address . The actions prescribed by these values 
are as foil ows : 

SIG DFL - terminate process upon receipt of a signal 
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Upon receipt of the signal si g , the receiving pro- 
cess is to be terminated with all of the conse- 
quences outlined in ex i t ( 2 ) ; a ''core image'* is 
made in the current working directory of the 
receiving process if s i g is one for which an 
asterisk appears in the above list and the follow- 
ing conditions are met: 

The effective user ID and the real user ID 
of the receiving process are equal. 

An ordinary file named core exists and is 
writable or can, be created. If the file 
must be created, it will have the follow- 
ing properties; 

a mode of 0666 modified by the 
file creation mask (see urn ask ( 2 ) ) 

a file owner ID that is the same 
as the effective user ID of the 
receiving process 

a file group ID that is the same 
as the effective group ID of the 
receiving process 

SIG__IGN - ignore signal 

The signal si g is to be ignored. 

Note: the signal SIGKILL cannot be ignored, 

functio n addr ess - catch signal 

Upon receipt of the signal si g , the receiving pro- 
cess is to execute the signal-catching function 
pointed to by f unc , The signal number si g is passed 
as the first argument to the signal-catching func- 
tion. A second argument, s i g cod e , is also passed 
to the function. Sig code has various contents, 
according to the value of sig . These values are 
provided in the table below. Before entering the 
signal-catching function, the value of f unc for the 
caught signal is set to SIG DFL unless the signal is 
SIGILL, SIGTRAP, or SIGPWR."* 

Upon return from the signal-catching function, the 
receiving process resumes execution at the point it 
was interrupted. See the WARNINGS section below. 

When a signal that is to be caught occurs during a 
r ead ( 2 ) , wr i te ( 2 ) , open ( 2 ) , or ioc tl ( 2 ) system call 
on a slow device (like a terminal; but not a file). 
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during a pa use ( 2 ) system call, or during a wa i t ( 2 ) 
system call that does not return immediately due to 
the existence of a previously stopped or zombie pro- 
cess, the signal catching function is executed; then 
the interrupted system call returns a -1 to the cal- 
ling process with er r no set to EINTP. 

Note; the signal SIGKILL cannot be caught. 

A call to signa l cancels a pending signal si g except for a 
pending SIGKILL signal. 

Signal fails if one or more of the following are true: 

Si g is an illegal signal number, including SIGKILL. 
LEIN VAL ] 

Func points to an illegal address, [EFAULT] 


The table below shows how SIGTRAP handles M 68000 traps. 
Most traps result in signals being sent to the user process 
that caused the trap. All other traps are considered to be 
STRAYFT, spurious interrupts. 

The following meanings apply to information in the ’’SIGNAL 
CODE” column of the table: 

code == address means the address causing the fault 

code == pc means the program counter value at the time 
ofthetrap 

code == (%d0) means the user parameter to the TRAP 

instruction 

The definitions of KINTDTV, KTNTOVF, and KSUBRNG are provided in 
the include file < sys/ si gnal . h> , 
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TRAP 

TRAP 



SIGNAL 

TYPE 

NO, 

ASSIGNMENT 

SIGNAL 

CODE 

BUSERR 

? 

bus error 

SIGBUS 

address 

ADDRERR 

3 

address error 

SIGTLL 

address 

INSTERR 

4 

illegal instruction 

SIGILL 

pc 

ZDVDERR 

5 

zero divide fault 

SIGFPE 

KINTDI V 

CHKTRAP 

6 

CHK instruction fault 

SIGFPE 

KSUBPNG 

TRAPVFT 

7 

TRAPV instruction fault 

SIGFPE 

KINTOVF 

PRIVFLT 

8 

privileged instruction 
fault 

SIGILL 

pc 

TRCTRAP 

9 

trace trap 

SIGTRAP 

pc 

L 1 01 OFT 

1 0 

line 1010 emulator 

SIGILL 

pc 

L 1 1 1 1FT 

1 1 

line 1111 emul ator 

SIGILL 

pc 

STRAYFT 

24 

spurious interrupt 

n/ a 

n/ a 

SYS CALL 

32 

TRAP 0 - system call 

n/ a 

(%d0) 

BPTFLT 

33 

TRAP 1 - breakpoint 

SIGTRAP 

pc 

lOTTRAP 

34 

TRAP 2 - simulate DEC 
lOT instruction 

SIGIOT 

(%d0) 

EMTTRAP 

35 

TRAP 3 - simulate DEC 
EMT instruction 

SIGEMT 

($d0) 

FPETRAP 

36 

TRAP 4 - floating point 
exception 

SIGFPE 

(%d0) 


PETUPN VALUE 

Upon successful completion, signal returns the previous 
value of f unc for the specified signal si g . Otherwise, a 
value of -1 is returned and err no is set to indicate the 
error . 

SEE ALSO 

kill(l), kill(2), pause(2), ptrace(2), wait(2), setjmpOC), 
WAPNINGS 

Two other signals that behave differently than the signals 
described above exist in this release of the system. They 
are; 


SIGCLD 18 death of a child (reset when caught) 
SIGPWP 19 power fail (not reset when caught) 

There is no guarantee that, in future releases of the UNIX 
System, these signals will continue to behave as described 
below; they are included only for compatibility with other 
versions of the UNIX System, Their use in new programs is 
strongly discouraged. 

For these signals, f unc is assigned one of three values: 
SIG_^DFL, SIG^IGN, or a function address , The actions 
prescribed by these values are as follows: 
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SIG__DFL - ignore signal 

The signal is to be ignored, 

SIG__IGN - ignore signal 

The signal is to be ignored. If s i g is SIGCLD, 
the calling process’s child processes do not 
create zombie processes when they terminate; see 
exi t ( 2 ) , 

func tion add ress - catch signal 

If the signal is SIGPWR, the action to be taken is 
the same as that described above for func equal to 
function address . The same is true if the signal 
is SIGCLD, except that, while the process is exe- 
cuting the signal-catching function, any received 
SIGCLD signals are queued and the signal-catching 
function is continually reentered until the queue 
is empty. 

The SIGCLD affects two other system calls ( wa i t ( 2 ) and 
ex i t ( 2 ) ) in the following ways: 

wait If the func value of SIGCLD is set to SIG__IGN and 
a wait is executed, the wait blocks until all of 
the calling process’s child processes terminate; 
it then returns a value of -1 with err no set to 
ECHILD, 

exit If in the exiting process’s parent process the 
func value of SIGCLD is set to SIG^^IGN, the exit- 
ing process does not create a zombie process. 

When processing a pipeline, the shell makes the last pro- 
cess in the pipeline the parent of the preceding 
processes, A process that may be piped into in this 
manner (and thus become the parent of other processes) 
should take care not to set SIGCLD to be caught. 

The ability to resume execution upon return from the 
signal-catching function is machine-dependent. For the 
M68000, resumption cannot occur after faults requiring 
instruction recovery. These faults are bus errors and 
address errors. 
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NAME 

stat, fstat - get file status 
SYNOPSIS 

linclude < sys/ t ype s . h> 

^include <sys/stat,h> 

int stat (path, buf) 
char *path; 
struct stat *buf; 

int fstat (fildes, buf) 
int fildes; 
struct stat *buf; 

DESCRIPTION 

Path points to a pathname naming a file. Read, write or 
execute permission of the named file is not required, but 
all directories listed in the pathname leading to the file 
must be searchable. Stat obtains information about the 
named file. 

Similarly, fstat obtains information about an open file 
known by the file descriptor fildes , obtained from a suc- 
cessful open ( 2 ) , cr eat ( 2 ) , d up ( 2 ) , f cnt 1 ( 2 ) , or pi pe ( 2 ) sys- 
tem call. 

Bu f is a pointer to a stat structure into which information 
is placed concerning the file. 

The contents of the structure pointed to by buf include the 
following members: 


u s h o r t 

st__ 

mod e ; 

/« 

File mode; see mknod(2) */ 


ino_t 

st__ 

ino ; 

/» 

Inode number */ 


d e v__^t 

st__ 

d ev ; 

/» 

ID of device containing */ 





/» 

a directory entry for this 

file «/ 

dev__t 

st__ 

rd ev ; 

/» 

ID of device */ 





/» 

This entry is defined only 

for * / 




/» 

character special or block 

*/ 




/» 

special files */ 


short 

st__ 

nl ink ; 

/» 

Number of links */ 


u s h 0 r t 

st~ 

ui d ; 

/» 

User ID of the file’s owner 

*/ 

ushor t 

st^ 

gid ; 

/* 

Group ID of the file’s group */ 

of f_t 

st__ 

si ze ; 

/» 

File size in bytes */ 


t i m e_ t 

st__ 

atime; 

/« 

Time of last access */ 


time t 

st_ 

mtime ; 

/« 

Time of last data modification */ 

t i m e_^ t 

st_^ 

ctime; 

/» 

Time of last file status change */ 




/» 

Times measured in seconds since */ 




/» 

00:00:00 GMT, Jan. 1, 1970 

»/ 


St atime , st mtime , and st ctime are changed by system calls 
as stated below. 
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s t a t i m e Time when file data was last accessed. Changed by 
the following system calls: cr eat ( 2 ) , mkno d ( 2 ) , 
pi pe ( 2 ) , u t i m e ( 2 ) , and r e ad ( 2 ) . 

st m ti m e Time when data was last modified. Changed by the 
following system calls; cr eat ( 2 ) , mknod ( 2 ) , 
pi pe ( 2 ) , u t ime ( 2 ) , and wr i te ( 2 ) . 

St ctime Time when file status was last changed. Changed 
by the following system calls: chmod ( 2 ) . cho wn ( 2 ) , 
c r ea t ( 2 ) , link ( 2 ) , ( 2 ) , pipe ( 2 ) , unlink ( 2 ) , 

ut ime ( 2 ) , and wr i te ( 2 ) . 

St a t fails if one or more of the following are true: 

A component of the path prefix is not a directory. 

[ENOTDIR] 

The named file does not exist. [ENOENT] 

Search permission is denied for a component of the path 

prefix. [EACCES] 

Buf or path points to an invalid address. [EFAULT] 

Fs t a t fails if one or more of the following are true; 

Fi 1 d e s is not a valid open file descriptor, [EBADF] 

Bu f points to an invalid address. [EFAULT] 

RETURN VALUE 

Upon successful completion a value of 0 is returned. Other- 
wise, a value of -1 is returned and err no is set to indicate 
the error. 

SEE ALSO 

chmod(2), chown(2), creat(2), link(2), mknod(2), time(2), 
uni ink( 2 ) . 


- 2 - 


Printed 6 1985 



UTIME(2) 


UTIME(2) 


NAME 

utime - set file access anrf modification times 
SYNOPSIS 

linclude < sys/ type s .h> 
int utime (path, times) 
char * pa th ; 

struct utimbuf *times; 

DESCRIPTION 

Path points to a pathname naming a file, Utime sets the 
access and modification times of the named file. 

^ ^ ^ s is NULL, the access and modification times of the 
file are set to the current time. A process must be the 
owner of the file or have write permission to use utime in 
this manner. 

If time s is not NULL, times is interpreted as a pointer to a 
utimbuf structure and the access and modification times are 
set to the values contained in the designated structure. 
Only the owner of the file or the superuser may use utime 
this way. 

The times in the following structure are measured in seconds 
since 00:00:00 GMT, Jan. 1, 1970. 

struct utimbuf { 

time__t actime; /* access time */ 

time__t modtime;/* modification time */ 

}; 

utime fails if one or more of the following are true: 

The named file does not exist. [ENOENT] 

A component of the path prefix is not a directory. 
[ENOTDIR] 

Search permission is denied by a component of the path 
prefix. [EACCES] 

The effective user ID is not superuser and not the 

owner of the file and times is not NULL. [EPERM] 

The effective user ID is not superuser and not the 

owner of the file, tiroes is NULL, and write access is 
denied. [EACCES] 

The file system containing the file is mounted reader- 
only. [EROFS] 

Times is not NULL and points outside the process's 
allocated address space. [EFAULT] 
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Path points outside the process’s allocated address 
space. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Oth- 
erwise, a value of -1 is returned and err no is set to indi- 
cate the error. 

SEE ALSO 

st a t ( 2 ) . 
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NAME 

intro - introduction to subroutinesand libraries 

SYNOPSIS 

finclude <stdio.h> 

^include <math.h> 

DESCRIPTION 

This section describes functions found in various libraries, 
other than those functions that directly invoke system prim- 
itives, which are described in Section 2 of this volume. 
Certain major collections are identified by a letter after 
the section number: 

(3C) These functions, together with those of Section 2 and 
those marked (3S), constitute the Standard C Library, 
1 i b c , which is automatically loaded by the C compiler, 
c_c( 1 ) . The link editor ^ ^ searches this library 
under the option. Some functions require declara- 

tions that can be included in the program being com- 
piled by adding the line 

finclude < he ad er f i 1 en ame > 

The appropriate //include file is indicated in the 
SYNOPSIS part of a function description. 

(3F) These functions constitute the FORTRAN intrinsic func- 
tion library, 1 ibF77 » These functions are automati- 
cally available to the FORTRAN progr amm er and require 
no special invocation of the compiler, 

(3M) These functions constitute the Math Library, 1 i bm . 

They are automatically loaded as needed by the FORTRAN 
compiler f 77 ( 1 ) . They are not automatically loaded by 
the C compiler, c_c ( 1 ) ; however, the link editor 
searches this library under the -Im option. Declara- 
tions for these functions may be obtained from the 
finclude file <inath.h>. 

(3S) These functions constitute the ''standard I/O pack- 
age’’; an introduction to this package is provided in 
St d io ( 3S ) . The functions are in the library 1 ib c , 
already mentioned. Declarations should be obtained 
from the finclude file <stdio.h>. 

(3X) Various specialized libraries. The files in which 
these libraries are found are given on the appropriate 
pages. 

For descriptions and examples of //include files, refer 
to the ’’Libraries” section of the Programming Guide. 


DEFINITIONS 

A charact er is any bit pattern able to fit into a byte on 
the machine. The null char ac ter is a character with value 
0, represented in the C language as ’ \0 ’ , A char ac ter array 
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is a sequence of characters. A null - terminated character 
array is a sequence of characters, the last of which is the 
iiHii character . A string is a designation for a n u 1 1 - 
terminated char ac ter array . The null string is a character 
array containing only the null character. A NULL pointer is 
the value that is obtained by casting 0 into a pointer. The 
C language guarantees that this value will not match that of 
any legitimate pointer, so many functions that return 
pointers return it to indicate an error. NULL is defined as 
0 in <stdio.h>; the user can Include his own definition if 
he is not using <stdio,h>. 

Many groups of FORTRAN intrinsic functions have g en eric 
function names that do not require explicit or implicit type 
declaration. The type of the function is determined by the 
type of its argument(s). For example, the generic function 
ma_x returns an integer value if given integer arguments 
T max 0 ) , a real value if given real arguments ( amax 1 ) , or a 
doubl e-pr ec i si on value if given double-precision arguments 
( dm ax 1 ) . 

FILES 

/lib/libc.a 

/usr/lib/libF77.a 

/lib/libm.a 

SEE ALSO 

ar(1), cc(1), f77(1), ld(l), nm ( 1 ) , intro(2), stdio(3S). 
Prog r amro ing Guide , 

DIAGNOSTICS 

Functions in the Math Library (3M) may return the conven- 
tional values 0 or HUGE (the largest single- precision 
floating-point number) when the function is undefined for 
the given arguments or when the value is not representable. 
In these cases, the external variable err no (see intro (2) ) 
is set to the value EDOM or ERANGE. Because many of the 
FORTRAN intrinsic functions use the routines found in the 
Math Library, the same conventions apply. 
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NAME 

a641, 164a - convert between long integer anrf base-64 ASCII 
string 

SYNOPSIS 

long a64 1 ( s) 
char * s ; 

char *164a (1) 
long 1; 

DESCRIPTION 

These functions are used to maintain numbers stored in 
b a se -6 4 ASCII characters. This is a notation by which long 
integers can be represented by up to 6 characters; each 
character represents a ''digit’’ in a radix-64 notation. 

The characters used to represent ''digits’’ are , for 0, / 
for 1, 0 through 9 for 2-11, A through Z for 12-37. and a 
through z for 38-63. 

A64 I takes a pointer to a nul 1- ter m in a ted base-64 represen- 
tation and returns a corresponding long value. If the 
string pointed to by _s contains more than 6 characters, a64 1 
uses the first 6. 

L64 a takes a long argument and returns a pointer to the 
corresponding base-64 representation. If the argument is 0, 
164a returns a pointer to a null string. 


BUGS 

The value returned by 164a is a pointer into a static 
buffer, the contents of which are overwritten by each call. 
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NAME 

abort - generate an lOT fault 

SYNOPSIS 

int abort ( ) 


DESCRIPTION 

Abort causes an lOT signal to be sent to the process. This 
usually results in terminationwith a core dump. 

It is possible for abort to return control if SIGIOT is 
caught or ignored, in which case the value returned is that 
system call. 

SEE ALSO 

adb(l), exitC?), kill(2), signal(2). 

DIAGNOSTICS 

If SIGIOT is neither caught nor ignored, and the current 
directory is writable, a core dump is produced and the mes- 
sage abort - core dumped is written by the shell. 
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NAME 

abs - return integer absolute value 

SYNOPSIS 

in t ab s ( i ) 
in t i ; 

DESCPIPTION 

Ab s returns the absolute value of its integer operand. 


BUGS 

In t wo ’ s-compl emen t representation, the absolute value of 
the negative integer with largest magnitude is undefined. 
Some implementations trap this error, but others simply 
i gnor e i t . 


SEE ALSO 

f 1 oor ( 3M ) . 
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NAME 

assert -- verify program assertion 
SYNOPSIS 

linclurfe <assert.h> 


assert (expression) 
int expression; 

DESCRIPTION 

This macro is useful for putting fiiagnostics into programs. 
If expression is false (zero) when assert is executed, 
assert prints 

Assertion failed: expression , fil e xyz , l ine nnn 

on the standard error output and aborts. In the error mes- 
sage, xy z is the name of the source file and nnn is the 
source line number of the assert statement. 

Compiling with the preprocessor option -DNDEBUG (see 
c pp ( 1 ) ) , or with the preprocessor control statement #define 
NDEBUG ahead of the #include <assert.h> statement, stops 
assertions from being compiled into the program, 

SEE ALSO 

cpp( 1 ) , abor t ( 30 . 
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NAME 

atof - convert ASCII string to floating-point number 
SYNOPSIS 

double atof (nptr) 
char *nptr; 

DESCRIPTION 

Atof converts a character string pointed to by nptr to a 
double-precision floating-point number. The first unrecog- 
nized character ends the conversion. Ato f recognizes an 
optional string of white-space characters (blanks or tabs), 
then an optional sign, then a string of digits optionally 
containing a decimal point, then an optional e or E followed 
by an optionally signed integer. If the string begins with 
an unrecognized character, atof returns the value zero. 

DIAGNOSTICS 

When the correct value would overflow, atof returns HUGE, 
and sets err no to EFANGE. Zero is returned on underflow. 

SEE ALSO 

sc an f ( 3S ) . 


^ 1 ^ 


Printed 6 1985 



lESSELCSM) 


BESSEL(3M) 


NAME 

yO. yTi y^ Bessel functions 

SYNOPSIS 

iinclude <math.h> 


double 

jo 

(x) 



double 

X ; 




double 

j 1 

(x) 



double 

X ; 




double 

jn 

( n , 

x) 


i n t n ; 





double 

X ; 




double 

yo 

(x) 



double 

X ; 




double 

yi 

(x) 



double 

X ; 




double 

yn 

( n , 

X) 


in t n ; 





double 

X ; 




DESCRIPTION 





J 0 and 

ji 

return Bessel functions of x of the first 

kind of 

orders 

0 

and 

1 respectively. ^ returns the Bessel 

function 


of first kind of order _n . 

Y 0 and vj_ return the Bessel functions of x of the second 
kind of orders 0 and 1 respectively, Tn returns the Bessel 
function of x of the second kind of order n. The value of >c 
must be positive. 

DIAGNOSTICS 

Non-positive arguments cause , and yn to return the 

value HUGE and to set err no to EDOM. They also cause a mes- 
sage indicating DOMAIN error to be printed on the standard 
error output; the process will continue. 

These error-handling procedures may be changed with the 
function matherr (3M) , 

SEE ALSO 

mather r ( 3M ) . 
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NAME 

bsearch - binary search 
SYNOPSIS 

char ^bsearch ((char *) key, (char *) base, nel, sizeof 
( *ke y) , compar ) 
unsigned nel ; 
in t ( *compar ) ( ) ; 

DESCRIPTION 

Bsearch is a binary search routine generalized from Knuth 
(6.2,1) Algorithm B. It returns a pointer into a table 
indicating where a datum may be found. The table must be 
previously sorted in increasing order according to a pro- 
vided comparison function. Ke y points to the datum to be 
sought in the table. Ba se points to the element at the base 
of the table. Nel is the number of elements in the table. 
Compar is the name of the comparison function, which is 
called with two arguments that point to the elements being 
compared. The function must return an integer less than, 
equal to, or greater than zero, depending on whether the 
first argument is to be considered less than, equal to, or 
greater than the second. 

DIAGNOSTICS 

A NULL pointer is returned if the key cannot be found in the 
table. 

NOTES 

The pointers to the key and the element at the base of the 
table should be of type po in ter- to-el emen t , and cast to type 
pointer-to-char acter . 

The comparison function need not compare every byte, so 
arbitrary data may be contained in the elements in addition 
to the values being compared. 

Although declared as type pointer-to-char acter , the value 
returned should be cast into type poin ter-to-element . 

SEE ALSO 

lsearch(3C), hsearch(3C), qsort(3C), tsearch(3C). 
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NAME 

clock - report CPU time used 

SYNOPSIS 

long clock ( ) 

DESCRIPTION 

Clock returns the amount of CPU time (in microseconds) used 
since the first call to clock . The time reported is the sum 
of the user and system tiroes of the calling process and its 
terminated child processes for which it has executed wa i t ( P ) 
or sys tem ( 3S ) . 

The resolution of the clock is 16,667 milliseconds on M68000 
or DEC processors. 

SEE ALSO 

times(2), wait(2), systemOS). 


BUGS 

The value returned by clock is defined in microseconds for 
compatibility with systems that have CPU clocks with much 
higher resolution. Because of this, the value returned 
wraps around after accumulating only 2,147 seconds of CPU 
time (about 36 minutes). 
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NAME 

toupper, tolower , __toupper, __tolower, toascii - translate 
characters 

SYNOPSIS 

linclude <ctype.h> 

in t toupper ( c) 
in t c ; 

int tolower (c) 
in t c ; 

int __to upper ( c) 
in t "c ; 

int __tolower (c) 
int c ; 

int toascii (c) 
in t c ; 

DESCRIPTION 

Toupper and t o 1 owe r have as domain the range of get c ( 3S ) : 
the integers from 1 through 255 , If the argument of 
toupper represents a lower-case letter, the result is the 
corresponding upper-case letter. If the argument of tolower 
represents an upper-case letter, the result is the 
corresponding lower-case letter. All other arguments in the 
domain are returned unchanged, 

toupper and to lower are macros that accomplish the same 
thing as toupper and to 1 ower but have restricted domains and 
are faster. to upper requires a lower-case letter as its 
argument; its result is the corresponding upper-case letter. 

tolower requires an upper-case letter as its argument; its 
result is the corresponding lower-case letter. Arguments 
outside the domain cause undefined results. 

Toascii yields its argument with all bits turned off that 
are not part of a standard ASCII character; it is intended 
for compatibility with other systems. 

SEE ALSO 

ctype(3C) , getc(3S) . 
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NAME 

crypt, setkey, encrypt - generate DES encryption 
SYNOPSIS 

char *crypt (key, salt) 
char *key, *salt; 

void setkey ( key) 
char •key; 

void encrypt (block, edflag) 
char *block; 
in t edflag; 

DESCRIPTION 

Cr yp t is the password encryption function. It is based on 
the NBS Data Encryption Standard (DES), with variations 
intended to frustrate use of hardware implementations of the 
DES for key search. 

Key is a user’s typed password. Salt is a 2*-character 
string chosen from the set [ a-z A-Z0-:-9 . / 3 ; this string is 
used to perturb the DES algorithm in one of 4,096 different 
ways, after which the password is used as the key to encrypt 
repeatedly a constant string. The returned value points to 
the encrypted password. The first 2 characters are the salt 
itself . 

The s etke y and encrypt entries provide (rather primitive) 
access to the actual DES algorithm. The argument of setke y 
is a character array of length 64 containing only the char- 
acters with numerical value 0 and 1. If this string is 
divided into groups of 8, the low-order bit in each group is 
ignored; this gives a 56-bit key which is set into the 
machine. The 56-bit key is used with the above-mentioned 
algorithm to encrypt or decrypt the string block with the 
function encrypt . 

The argument to the encrypt entry is a character array of 
length 64 containing only the characters with numerical 
value 0 and 1. The argument array is modified in place to a 
similar array representing the bits of the argument after 
having been subjected to the DES algorithm using the key set 
setkey . If ed flag is zero, the argument is encrypted; if 
non-zero, it is decrypted. 

SEE ALSO 

login(l), passwd(i), getpass(3C), passwd(4). 


BUGS 

The return value points to static data that is overwritten 
by each call. 


1 


Printed 6 1985 



eTEPMID(3S) 


CTERMID(3S) 


NAME 

ctermifi - generate filename for terminal 
SYNOPSIS 

#include <stdio.h> 

char *ctermid(s) 
char *s; 

DESCRIPTION 

Ct er m id generates the pathname of the controlling terminal 
for the current process, and stores it in a string. 

If _s is a NULL pointer, the string is stored in an internal 
static area, the contents of which are overwritten at the 
next call to c t er m i d , and the address of which is returned. 
Otherwise, s is assumed to point to a character array of at 
least L_^ctermid elements; the pathname is placed in this 
array and the value of £ is returned. The constant 
L^ctermid is defined in the <stdio.h> header file. 

NOTES 

The difference between c termid and ttyname C 3C) is that 
1 1 y n am e must be handed a file descriptor and returns the 
actual name of the terminal associated with that file 
descriptor, while c term id returns a string (/dev/tty) that 
refers to the terminal if used as a filename. For this rea- 
son, 1 1 yname is useful only if the process already has at 
least one file open to a terminal, 

SEE ALSO 

ttynameC 3C) . 


1 - 


Printed 6 1985 



CTIMEC3C) 


CTIMECSC) 


NAME 

ctime, localtime, gmtime, asctime, tzset convert date and 
timetostring 

SYNOPSIS 

finclude <tiiiie.h> 

char •ctime (clock) 
long *clock; 

struct tm •localtime (clock) 
long •clock; 

struct tm •gmtime (clock) 
long •clock; 

char •asctime (tm) 
struct tm •tm; 

extern long timezone; 

extern int daylight; 

extern char •tzname[ 2 ]; 

void tzset ( ) 

DESCRIPTION 

Ctim e converts a long integer, pointed to by clock , 
representing the time in seconds since 00:00:00 GMT, January 
1, 1970 , and returns a pointer to a 26<-char ac ter string in 

the following form. All the fields have constant width. 

Sun Sep 16 01:03:52 1973\n\0 

Loc al time and gmtime return pointers to structures, 

described below. Localtime corrects for the time zone and 
possible Daylight Savings Time; gmtime converts directly to 
Greenwich Mean Time (GMT), which is the time the system 
uses. 

As ctime converts a structure to a 26-character string, as 
shown in the above example, and returns a pointer to the 
string. 

Declarations of all the functions and externals, and the 
structure, are in the < time .h> header file. The structure 
decl ar ation i s : 

struct tm { 

int tra___sec; /* seconds (0 - 59) •/ 

int tm__min; /• minutes (0 - 59) */ 

int tm__hour; /• hours (0 - 23 ) */ 

int tm roday; /• day of month (1 - 31 ) »/ 
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int ttn__mon ; /* month of year (0 11) */ 

int tm__year; /*year- 1900 */ 
int tm__wday; /* day of week (Sunday = 0) */ 
int tm___yday; /* day of year (0 - 365 ) */ 
int tm___i sd st ; 

); 

Tm isdst is non-zero if Daylight Savings Time is in effect. 

The external long variable tim ezone contains the difference, 
in seconds, between GMT and local standard time (in EST, 
timezone is 5*60*60); the external variable daylight is 
non-zero if, and only if, the standard U.S.A. Daylight Sav- 
ings Time conversion should be applied. The program knows 
about the peculiarities of this conversion in 1974 and 1975; 
if necessary, a table for these years can be extended. 

If an environment variable named TZ is present, a sc tim e uses 
the contents of the variable to override the default time 
zone. The value of TZ must be a 3'-letter time zone name, 
followed by a number representing the difference between 
local time and Greenwich Mean Time in hours, followed by an 
optional 3-letter name for a daylight time zone. For exam- 
ple, the setting for New Jersey would be EST5EDT. The 
effects of setting TZ are thus to change the values of the 
external variables timezone and daylight ; in addition, the 
time zone names contained in the external variable 

char »tzname[2] = { "EST", "EDT" ); 

are set from the environment variable TZ . The function 
t zse t sets these external variables from TZ ; t zse t is called 
by asctime and may also be called explicitly by the user. 

Note that in most installations, TZ is set by default when 
the user logs on, to a value in the local /etc/profile file 
(see pro f i 1 e ( 4 ) ) . 

SEE ALSO 

time(2), getenv(3C), profile(4), environ(5). 


BUGS 

The return values point to static data whose content is 
overwritten by each call. 
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NAME 

isalpha, isupper, islower, is<iigit, isxdigit, isalnum, 
isspace, ispunct, isprint, isgraph, iscntrl, isascii - clas- 
sify characters 


SYNOPSIS 

linclude <ctype.h> 

int isalpha (c) 
in t c ; 


DESCRIPTION 

These macros classify character-coded integer values by 
table lookup. Each is a predicate returning nonzero for 
true, zero for false. Isascii is defined on all integer 
values; the rest are defined only where isascii is true and 
on the single non-ASCII value EOF (-1); see std io ( 3$ ) ) . 


i sal pha 

c is a letter. 


isupper 

c is an upper-case letter. 


i slower 

£ is a lower-case letter. 


isdigit 

£ is a digit [0-9 ] . 


isxdigit 

c is a hexadecimal digit [0-9]» [A-F] 
f] . 

or [ a- 

isalnum 

c is an alphanumeric (letter or digit) 

• 

isspace 

c is a space, tab, carriage return, new-line, 
vertical tab, or form-feed. 

i spunc t 

c is a punctuation character (neither 

control 


nor alphanumeric). 


i s pr in t 

c is a printing character, code OMO 
through 0176 (tilde). 

( space) 

i sgr aph 

c is a printing character, similar to 
except false for space. 

i spr in t 

iscntrl 

c is a delete character (0177) or an ordinary 
control character (less than 040). 

isascii 

c is an ASCII character, code less than 0200. 


DIAGNOSTICS 

If the argument to any of these macros is not in the domain 
of the function, the result is undefined. 
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NAME 

cuserid - get character login name of the user 
SYNOPSIS 

finclude <stdio.h> 

char •cuserid (s) 
char •s; 

DESCPIPTION 

Cuserid generates a character*-string representation of the 
login name of the owner of the current process. If _s is a 
NULL pointer, this representation is generated in an inter-r- 
nal static area, the address of which is returned. Other- 
wise, £ is assumed to point to an array of at least 
L__cuserid characters; the representation is left in this 
array. The constant L^^cuserid is defined in the <stdio.h> 
header file. 

DIAGNOSTICS 

If the login name cannot be found, c userid returns a NULL 
pointer; if _s is not a NULL pointer, a null character (\0) 
is placed at 

SEE ALSO 

getlogin(3C), getpwent(3C). 
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NAME 

dial - establish an out-going terminal line connection 
SYNOPSIS 

finclude <dial.h> 


in t d ial (call) 

CALL »call; 

void undial (fd) 
int f d ; 

DESCRIPTION 

Dial returns a file descriptor for a terminal line open for 
read/write. The argument to dial is a CALL structure 
(defined in the <dial.h> header file. 


When finished with the terminal line, the calling program 
must invoke undial to release the semaphore that has been 
set during the allocation of the terminal device. 

The CALL typedef in the <dial.h> header file is: 


typedef struct { 

struct termio *attr;/* 
int baud ; /* 

int speed ; /» 

char *line; /* 

char * te 1 no ; /* 

int mod em ; /* 

} CALL; 


pointer to termio attribute strucj" */ 
transmission data rate */ 

212A modem: low=300, high=1200 */ 
device name for out-going line */ 
pointer to tel-no digits string */ 
specify modem control for direct line 


The CALL element speed is intended only for use with an out- 
going dialed call, in which case its value should be either 
300 or 1200 to identify the 1 1 3A modem, or the high-speed or 
low-speed setting on the 212A modem. The CALL element baud 
is for the desired transmission baud rate. For example, one 
might set baud to 110 and speed to 3^0 (or 1200), 

If the desired terminal line is a direct line, a string 
pointer to its device name should be placed in the line ele- 
ment in the CALL structure. Legal values for such terminal 
device names are kept in the L«^ dev ic es file. In this case, 
the value of the baud element need not be specified as it 
will be determined from the L«^ dev ices file. 

The tel no element is for a pointer to a character string 
representing the telephone number to be dialed. Such 
numbers may consist only of symbols described on the acu ( 7 ) . 
The termination symbol will be supplied by the dial func- 
tion, and should not be included in the telno string passed 
^ ^ al in the CALL structure. 
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The CALL element mo<i em is used to specify modem control for 
direct lines. This element should be non*-zero if modem con- 
trol is required. The CALL element a t tr is a pointer to a 
termio structure, as defined in the <termio,h> header file, 
A NULL value for this pointer element may be passed to the 
dia l function, but if such a structure is included, the ele- 
ments specified in it will be set for the outgoing terminal 
line before the connection is established. This is impor- 
tant for attributes such as parity and baud rate. 


FILES 

/usr/lib/uucp/L-devices 
/ usr / spool / uu c p/ L CK . , tty- device 

SEE ALSO 

uucp(IC), alarra(2), read(2)» write(2). 
termioC?) in the Adm inistrator * s Manual . 

DIAGNOSTICS 

On failure, a n eg a t i v e v al ue indicating the reason for the 
failure is returned. Mnemonics for these negative indices 
as listed here are defined in the <dial.h> header file. 

INTRPT -1 
D_HUNG -2 
NO__ANS -3 
ILL_BD -M 
A_PFOB -5 
L PPOB -6 
NTI_Ldv -7 
DV__NT_A -8 
DV__NT_K -9 
NO_BD_A -10 
N0_BD_K -11 

WARNINGS 

Including the <dial.h> header file automatically includes 
the <termio.h> header file. 

Because the above routine uses <stdio.h>, the size of pro- 
grams not otherwise using standard I/O is increased more 
than might be expected. 

BUGS 

An al arm ( 2 ) system call for 3»600 seconds is made (and 
caught) within the dial module for the purpose of ''touch- 
ing’’ the LCK . . file and constitutes the device allocation 
semaphore for the terminal device. Otherwise, uuc p ( 1 C ) may 
simply delete the LCK . . entry on its 90-minute clean-up 
rounds. The alarm may go off while the user program is in a 
r ead ( 2 ) or wr i t e ( 2 ) system call, causing an apparent error 
return. If the user program is to run for an hour or more, 
error returns from read s should be checked for 
( er r no = = E INTR ) , and the r ead possibly reissued. 


/* interrupt occured */ 

/* dialer hung (no return from write) */ 
/* no answer within 10 seconds */ 

/* illegal baud-rate */ 

/* acu problem (open() failure) */ 

/* line problem (open() failure) */ 

/* can’t open LDEVS file */ 

/* requested device not available */ 

/* requested device not known */ 

/* no device available at requested baud 
/• no device known at requested baud */ 
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NAME 

drand48, erand^S, lrand48, nrand48, mrand48, jrandM8, 
srand48, 3eed48, lcong48 - generate uniformly distributed 
pseudo-random numbers 

SYNOPSIS 

double drand48 ( ) 

double erand48 (xsubi) 
unsigned short xsubiC3]; 

long lrand48 ( ) 

long nrand48 (xsubi) 
unsigned short xsubi[3]; 

long mrand48 ( ) 

long jrand48 (xsubi) 
unsigned short xsubi[3]; 

void srand48 (seedval) 
long seedval ; 

unsigned short *seed48 (seedl6v) 
unsigned short seedl6vC3]; 

void lcong48 (param) 
unsigned short paramC?]; 

DESCRIPTION 

This family of functions generates pseudo-random numbers 
using the well-known linear congruential algorithm and 48- 
bit integer arithmetic. 

Functions d rand 4 8 and er and 4 8 return non-negative double- 
precision floating-point values uniformly distributed over 
the interval $ [ 0 . 0 , ~ 1 . 0 ) . $ 

Functions 1 r and 4 8 and nrand48 return non-negative long 
integers uniformly distributed over the interval $[0,~2 sup 
31 ) .$ 

Functions mr and48 and jr and48 return signed long integers 
uniformly distributed over the interval $[-2 sup 31 ,~2 sup 

31 ).$ 

Functions sr and 4 8 , seed 48 , and lcong48 are initialization 
entry points, one of which should be invoked before d rand 48 , 
Ir and 4 8 , or mr and 4 8 is called. (Although it is not recom- 
mended practice, constant default initializer values are 
supplied automatically if drand48 , Ir and48 . or mr an d48 is 
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called without a prior call to an initialization entry 
point.) Functions er and M 8 , nr and 4 8 . and j r and 4 8 do not 
require an initialization entry point to be called first. 

All the routines work by generating a sequence of 48-bit 


integer values, $X sub i ,$ according to the linear 
congruential formula 

X sub { n+ 1 } ~ = ~ ( aX sub n'' + ''c) subiroman raod~in} n> = 0. 


The parameter $m'' = ''P sup 48$*, hence 48-bit integer arith- 
metic is performed. Unless 1 cong 4 8 has been invoked, the 
multiplier value $a$ and the addend value $c$ are given by 

a~mark =~roman 5DEECE66D''sub 16''=~roman 

273673 1 63 1 55''sub 8 

c~lineup =~roman B''sub l6~=~roman 13''sub 8 . 

The value returned by any of the functions d r and 4 8 . er and 4 8 , 
1 r and 4 8 , n r and 4 8 , mr and 4 8 , or j r and 4 8 is computed by first 
generating the next 48-bit $X sub i$ in the sequence. Then 
the appropriate number of bits, according to the type of 
data item to be returned, are copied from the high-order 
(leftmost) bits of $X sub i$ and transformed into the 
r et ur ned v al ue . 

The functions d r and 4 8 , 1 r and 4 8 , and mr and 48 store the last 
48-bit $X sub i$ generated in an internal buffer; that is 
why they must be initialized prior to being invoked. The 
functions er and 4 8 , nr and 4 8 , and j r and 4 8 require the calling 
program to provide storage for the successive $X sub i$ 
values in the array specified as an argument when the func- 
tions are invoked. That is why these routines do not have 
to be initialized; the calling program merely has to place 
the desired initial value of $X sub i$ into the array and 
pass it as an argument. By using different arguments, func- 
tions er and 4 8 , nr and 4 8 , and jr and48 allow separate modules 
of a large program to generate several ind e pend en t streams 
of pseudo-random numbers, i.e., the sequence of numbers in 
each stream does not depend upon how many times the routines 
have been called to generate numbers for the other streams. 

The initializer function sr and 4 8 sets the high-order 32 bits 
of $X sub i$ to the 32 bits contained in its argument. The 
low-order 16 bits of $X sub i$ are set to the arbitrary 
value $roman 330 E sub 16 .$ 

The initializer function se ed 4 8 sets the value of $X sub i$ 
to the 48-bit value specified in the argument array. The 
previous value of $X sub i$ is copied into a 48-bit internal 
buffer, used only by seed 4 8 . A pointer to this buffer is the 
value returned by seed 4 8 . The returned pointer, which can be 
ignored if not needed, is useful if a program is to be res- 
tarted from a given point at some future time. Use the 
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pointer to get and store the last $X sub i$ value; then use 
this value to reinitialize via se ed 4 8 when the program is 
restarted . 

The initialization function 1 cong4 8 allows the user to 
specify the initial $X sub i ,$ the multiplier value $a,$ 
and the addend value $c.$ Argument array elements par am [ 0<r.? ] 
specify $X sub i ,$ elements par am [ 3"-5 ] specify the multi- 
plier $a,$ and par am [ 6 ] specifies the 16-bit addend $c.$ 
After 1 cong48 has been called, a subsequent call to either 
sr and 4 8 or seed 4 8 will restore the ''standard’* multiplier 
and addend values, $a$ and $c,$ specified on the previous 
page . 


NOTES 

The versions of these routines for the VAX-11 and PDP-11 are 
coded in assembly language for maximum speed. It requires 
approximately 80 Msec on a VAX-11/780 and 1 30 Msec on a 
PDP-11/70 to generate one pseudo-random number. On other 
computers, currently including the M68000 processors, the 
routines are coded in portable C. The source code for the 
portable version can even be used on computers which do not 
have floating-point arithmetic. In such a situation, func- 
tions drand48 and er and 48 do not exist; instead, they are 
replaced by the following two functions: 

long irand48 Cm) 
unsigned short m; 

long krand48 (xsubi, m) 
unsigned short xsubi[3]* m; 

Functions i r and 4 8 and kr and 4 8 return non-negative long 
integers uniformly distributed over the interval $[0,~m-1 
].$ 


SEE ALSO 

rand ( 3 c) . 
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NAME 

ecvt, fcvt, gcvt - convert floating-point number to string 
SYNOPSIS 

char *ecvt (value, ndigit, decpt, sign) 
double value; 

int ndigit, *decpt, *sign; 

char *fcvt (value, ndigit, decpt, sign) 
double value; 

int ndigit, *decpt, »sign; 

char *gcvt (value, ndigit, buf) 
double value; 
char *buf; 

DESCRIPTION 

Ecvt converts v al ue to a null-terminated string of ndigit 
digits and returns a pointer to this string. The low-order 
digit is rounded. The position of the decimal point rela- 
tive to the beginning of the string is stored indirectly 
through d ec pt (negative means to the left of the returned 
digits). The decimal point is not included in the returned 
string. If the sign of the result is negative, the word 
pointed to by sign is non-zero; otherwise it is zero. 

Fcvt is identical to ec v t , except that the correct digit has 
been rounded for Fortran F-format output of the number of 
digits specified by ndigit . 

Gcvt converts the value to a null-terminated string in the 
array pointed to by buf and returns buf . It attempts to 
produce ndigit significant digits in Fortran F-format, ready 
for printing; E-format is produced when F-format is not pos- 
sible. A minus sign, if there is one, or a decimal point is 
included as part of the returned string. Trailing zeros are 
suppressed . 

SEE ALSO 

pr intf ( 3S ) . 

BUGS 

The return values point to static data whose content is 
overwritten by each call. 
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NAME 

end, etext, edata - last locations in program 

SYNOPSIS 

extern end; 
extern etext; 
extern ed a ta ; 

DESCRIPTION 

These names refer neither to routines nor to locations with 
interesting contents. The address of etext is the first 
address above the program text, ed a ta above the initialized 
data region, and end above the uninitialized data region. 


When execution begins, the program break (the first location 
beyond the data) coincides with end , but the program break 
may be reset by the routines of br k ( 2 ) , malloc (3C) , standard 
input/output ( St d io ( 3S ) ) , the profile (-p) option of cc ( 1 ) , 
and others. Thus, the current value of the program break 
should be determined by sbrk(O) (see br k ( 2 ) ) . 

SEE ALSO 

brk(2), malloc(3C). 
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NAME 


erf, erfc - error function and complementary error function 
SYNOPSIS 

finclude <math.h> 


double erf ( x ) 
double x; 

double erfc ( x) 
double x; 

DESCRIPTION 

Erf returns the error function of 5C , defined as {2 over sqrt 
pi} int from 0 to x e sup t sup 2) dt . 

Erfc , which returns 1.0 - er f ( x ) , is provided because of the 
extreme loss of relative accuracy if er f ( x ) is called for 
large _x and the result subtracted from 1.0 (e.g. for _x = 5, 

12 places are lost). 

SEE ALSO 

exp( 3M) . 
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NAME 

exp, log, logic, pow, sqrt - exponential, logarithm, power, 
square root functions 


SYNOPSIS 

finclude <math.h> 


double 

double 

exp ( X ) 

X ; 

double 

double 

log (x) 
x; 

double 

double 

logic (x) 

X ; 

double 

double 

pow (x, y) 
X , y ; 

double 

double 

sqrt (x) 

X ; 

DESCRIPTION 



Ex p returns e82c9 . 

Log returns the natural logarithm of x. The value of x must 
be positive. 

Log 1 0 returns the logarithm base ten of . The value of x 
must be posi tive . 

Pow returns ^Qy9. The values of x and y may not both be zero 
If X is non-positive, must be an integer, 

' Sqr t returns the square root of jc , The value of may not 

be n eg a t i V e , 

DIAGNOSTICS 

Exp returns HUGE when the correct value would overflow, and 
sets err no to ERANGE. 

Log and l ogic return C and set err no to EDOM when x is non- 
positiveT An error message is printed on the standard error 
out put . 

Pow returns 0 and sets err no to EDOM when x is non-positive 
and ^ is not an integer, or when x and jr are both zero. In 
these cases a message indicating DOMAIN error is printed on 
the standard error output. When the correct value for pow 
would overflow, pow returns HUGE and sets err no to ERANGE. 

Sqrt returns 0 and sets err no to EDOM when x is negative, A 
message indicating DOMAIN error is printed on the standard 
error output. 
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These error- handling procedures may be changed with 
function m a t h e r r ( 3 M ) . 

SEE ALSO 

hypot(3M), matherr(3M), sinh(3M), 


the 
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NAME 

fclose, fflush - close or flush a stream 
SYNOPSIS 

linclude <stdio.h> 

int fclose (stream) 

FILE ^stream; 

int fflush (stream) 

FILE ^stream.; 

DESCRIPTION 

Fclose causes any buffered data for the named stream 
written out and the stream to be closed, 

Fclose is performed automatically for all open files 
calling exit ( 2 ) . 

Fflush causes any buffered data for the named stream 
written to that file. The stream remains open, 

DIAGNOSTICS 

These functions return 0 for success, and EOF if any 
(such as trying to write to a file that has not been 
for writing) was detected, 

SEE ALSO 

close(2), exit(2), fopen(3S), setbuf(3S). 
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NAME 

Terror, feof, clearerr, fileno - stream status inquiries 
SYNOPSIS 

linclude <stdio.h> 

in t f eo f (stream) 

FILE*stream; 

int Terror (stream) 

FILE ^stream; 

void clearerr (stream) 

FILE •stream; 

int fileno (stream) 

FILE *stream; 

DESCRIPTION 

F_eo f returns non-zero when EOF has previously been detected 
reading the named input stream ; otherwise, it returns zero. 

Fer r o r returns non-zero when an I/O error has previously 
occurred reading from or writing to the named stream ; other- 
wise, it returns zero. 

Clear err resets the error indicator and EOF indicator to 
zero on the named st r ea rn . 

Fi leno returns the integer file descriptor associated with 
TBe named str earn ; see o pen ( 2 ) . 


NOTE 

All these functions are implemented as macros; they cannot 
be declared or redeclared. 


SEE ALSO 

open(2), fopen(3S), 
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NAME 


floor, ceil, fmod , fabs - floor, ceiling, remainder, abso- 
lute value functions 


SYNOPSIS 

finclude <inath,h> 

double floor ( x ) 
double x; 

double ceil (x) 
double x; 

double fmod ( x , y ) 
double X , y ; 

double fabs (x) 
double x; 

DESCRIPTION 

Floor returns the largest integer (as 


a double-precision 


number) not greater than x. 

Ceil returns the smallest integer not less than x, 

Fmod returns x if y is zero; otherwise, it returns the 
number _f with the same sign as such that £ = + _f for 

some integer i, and [f[ < lyi. 


Fabs returns 1 x i . 


SEE ALSO 

abs( 3C) . 
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NAME 

fopen, freopen, fdopen - open a stream 
SYNOPSIS 

linclude <stdio.h> 

FILE *fopen (filename, type ) 
char ^filename, *type; 

FILE *freopen (filename, type, stream) 
char ^filename, *type; 

FILE ^stream; 

FILE *fdopen (fildes, type) 
int fildes; 
char *type; 

DESCRIPTION 

Fo pen opens the file named by f i 1 enam e and associates a 
stream with it, Fopen returns a pointer to the FILE struct 
ture associated with the stream . 

Filename points to a character string that contains the name 
of the file to be opened. 

Type is a character string having one of the following 

values: 

r open for reading 

w truncate or create for writing 

a append; open for writing at end of file, or 

create for writing 

r+ open for update (reading and writing) 

w+ truncate or create for update 

a+ append; open or create for update at end-of- 

file 

Freopen substitutes the named file in place of the open 
stream . The original str earn is closed, regardless of 
whether the open ultimately succeeds. Freopen returns a 
pointer to the FILE structure associated with stream . 

Freopen is typically used to attach the preopened str earn s 
associated with stdin, stdout, and stderr to other files. 

Fdopen associates a str earn with a file descriptor by format- 
ting a file structure from the file descriptor. Thus, f d o- 
pen can be used to access the file descriptors returned by 
open ( 2 ) , d up ( 2 ) , creat (2) , or pi pe ( 2 ) . (These calls open 
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files but do not return pointers to a FILE structure.) The 
type of stream must agree with the mode of the open file. 

When a file is opened for update, both input and output may 
be done on the resulting stream . However, output may not be 
directly followed by input without an intervening fseek or 
rewind . and input may not be directly followed by output 
without an intervening fseek , rewind , or an input operation 
which encounters end^of-'file. 

When a file is opened for append (i.e., when type is "a" or 
"a+"), it is impossible to overwrite information already in 
the file. Fseek may be used to reposition the file pointer 
to any position in the file, but when output is written to 
the file the current file pointer is disregarded. All ojut^ 
put is written at the end of the file and causes the file 
pointer to be repositioned at the end of the output. If two 
separate processes open the same file for append, each pro- 
cess may write freely to the file without fear of destroying 
output being written by the other. The output from the two 
processes will be intermixed in the file in the order in 
which it is written. 

SEE ALSO 

open(2), fclose(3S). 

DIAGNOSTICS 

Fo pen and fr eo pen return a NULL pointer on failure. 
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NAME 

frea(i, fwrite - binary input/output 
SYNOPSIS 

linclude <stdio.h> 


int fread (ptr, size, nitems, stream) 

char * pt r ; 

int size, n i terns ; 

FILE ^stream; 

int fwrite (ptr, size, nitems, stream) 

char •ptr; 

int si ze , nitems ; 

FILE •stream; 


DESCRIPTION 

FYea£ copies nitems items of data from the named input 
stream into an array beginning at ptr . An item of data is a 
sequence of bytes (not necessarily terminated by a null 
byte) of length size , Fr e ad stops appending bytes if an 
end-of-file or error condition is encountered while reading 
stream or if nitems items have been read. Fr e ad leaves the 
file pointer in stream , if defined, pointing to the byte 
following the last byte read if there is one. Fr e ad does 
not change the contents of stream . 


Fwrite appends at most n i tern s items of data from the the 
array pointed to by ptr to the named output stream . Fwr i te 
stops appending when it has appended nitems items of data or 
if an error condition is encountered bn strea m . Fwrite does 
not change the contents of the array pointed to by ptr . 


The variable size is typically s i zeo f ( • pt r ) where 
pseudo-func tion si zeo f specifies the length of an 
pointed to by ptr . If ptr points to a data type other 
char it should be cast into a pointer to char. 


the 

item 

than 


SEE ALSO 

read(2), write(2), fopenOS), getc(3S), gets(3S), 
printf(3S), putc(3S), puts(3S), scanf(3S). 

DIAGNOSTICS 

Fread and fwr i te return the number of items read or written. 

^ ^ bems is nonT> po si t i v e , no characters are read or written 
and 0 is returned by both fread and fwr i t e . 
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NAME 

frexp, l<iexp, moH f ^ manipulate parts of floating-point 
numbers 

SYNOPSIS 

double frexp (value, eptr) 

doublevalue; 

int •eptr; 

double Idexp (value, exp) 
double value; 
int exp ; 

double modf (value, iptr) 
double value, •iptr; 

DESCRIPTION 

Every non-zero number can be written uniquely as x* 28n9 
where the ''mantissa*' (fraction) x is in the range 0.5 < 
l_xl < 1.0, and the ''exponent'' n is an integer. Fr ex p 
returns the mantissa of a double value , and stores the 
exponent indirectly in the location pointed to by eptr . 

L d e X p returns the quantity value d 28 ex p 9 . 

Mod f returns the signed fractional part of value and stores 
the integral part indirectly in the location pointed to by 

DIAGNOSTICS 

If Idexp would cause overflow, HUGE is returned and err n o is 
set to ERANGE. 
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NAME 

fseek, rewind, ftell - reposition a file pointer in a stream 
SYNOPSIS 

#include <stdio.h> 

int fseek (stream, offset, ptrname) 

FILE*stream; 
long offset; 
int ptrname; 

void rewind (stream) 

FILE ^stream; 

long ftell (stream) 

FILE ^stream; 

DESCRIPTION 

Fseek sets the position of the next input or output opera- 
tion on the str earn . The new position is at the signed dis- 
tance offset bytes from the beginning, the current position, 
or the end of the file, when the value of ptr nam e is 0, 1, 

or ?, respectively. 

Re wi nd ( str earn ) is equivalent to f seek ( str earn , OL , 0), except 
that no value is returned. 

Fseek and rewind undo any effects of ungetc (3S) . 

After fsee k or rewind , the next operation on a file opened 
for update may be either input or output. 

Ftell returns the offset of the current byte relative to the 
beginning of the file associated with the named str earn . 

SEE ALSO 

lseek(2), fopen(3S). 

DIAGNOSTICS 

Fseek returns non-zero for improper seeks; otherwise it 
returns zero. An improper seek can be, for example, an 
fseek done on a file that has not been opened via fo pen ; in 
particular, fseek may not be used on a terminal or on a file 
opened via po pen ( 3^ ) » 

WARNING 

On an offset returned by ftell is measured in bytes, and it 
is permissible to seek to positions relative to that offset; 
however, portability to systems other than requires that an 
offset be used by fseek directly. Arithmetic may not mean- 
ingfully be performed on such an offset, which is not neces- 
sarily measured in bytes. 
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NAME 

ftw - walk a file tree 
SYNOPSIS 

finclude <ftw.h> 

int ftw (path, fn, depth) 
char *path; 
int («fn) ( ) ; 

int depth; 

DESCRIPTION 

Ftw recursively descends the directory hierarchy rooted in 
path . For each object in the hierarchy, ftw calls _fn, pass- 
ing it a pointer to a null-terminated character string con- 
taining the name of the object, a pointer to a stat struc- 
ture (see st a t ( 2 ) ) containing information about the object, 
and an integer. Possible values of the integer, defined in 
the <ftw.h> header file, are FTW_^F for a file, FTW__D for a 
directory, FTW__DNP for a directory that cannot be read, and 
FTW__NS for an object for which stat could not be executed 
successfully. If the integer is FTW_^DNF , descendants of 
that directory will not be processed. If the integer is 
FTW^NS, the stat structure will contain garbage. An example 
of an object that would cause FTW_NS to be passed to £n is a 
file in a directory with read permission but not execute 
(search) permission. 

Ft w visits a directory before visiting any of its descen- 
dants. 

The tree traversal continues until the tree is exhausted, an 
invocation of returns a nonzero value, or an error is 

detected within ft w (such as an I/O error). If the tree is 
exhausted, ft w returns zero. If £n returns a nonzero value, 
ft w stops its tree traversal and returns whatever value was 
returned by £n. If ftw detects an error, it returns -1, and 
sets the error type in er r no . 

Ftw uses one file descriptor for each level in the tree. 
The depth argument limits the number of file descriptors so 
used. If depth is zero or negative, the effect is the same 
as if it were 1. Depth must not be greater than the number 
of file descriptors currently available for use. Ftw runs 
more quickly if depth is at least as large as the number of 
levels in the tree. 

SEE ALSO 

stat(2), malloc(3C). 


BUGS 

Because ft w is recursive, it is possible for it to terminate 
with a memory fault when applied to very deep file struc- 
tures . 
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Ft w coulri be rna<ie to run faster and use less storage on deep 
structures at the cost of considerable complexity. 

Ft w uses ma lloc ( 3C) to allocate dynamic storage during its 
operation. Tf f t w is forcibly terminated, such as by 
1 o n g j m p being executed by fn or an interrupt routine, ft w 
does not have a chance to free that storage, so it remains 
permanently allocated. A safe way to handle interrupts is 
to store the fact that an interrupt has occurred, and 
arrange to have _fn return a nonzero value at its next invo- 
cation. 
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NAME 

gamma - log gamma function 

SYNOPSIS 

linclude <math.h> 

extern int signgam; 

double gamma (x) 
double X ; 

DESCRIPTION 

Gamm a returns the natural log of gamma as a function of the 
absolute value of a given value, delim $$ Gamm a returns $ln 
( i GAMMA ( X ) 1 )$, where $GAMMA ( x ) $ i s defined as 


$int from 0 to inf e sup { ^ t } t sup { x 1 } dt$. 

The sign of GAMMA ( ^ x ) is returned in the external 
integer signga m . The argument x may not be a non-positive 
integer . 

The following C program fragment might be used to calculate 
G : 


if ((y = gamma(x)) > LOGHUGE) 
er r o r ( ) ; 

y = signgam * exp(y); 

where LOGHUGE is the least value that causes ex p ( 3M ) to 
return a range error. 

DIAGNOSTICS 

For non-negative integer arguments HUGE is returned, and 
err no is set to EDOM. A message indicating DOMAIN error is 
printed on the standard error output. 

If the correct value would overflow, gamma returns HUGE and 
sets err no to ERANGE. 

These error-handling procedures may be changed with the 
function matherr (3M) . 

SEE ALSO 

exp(3M), matherr(3M). 


- 1 - 


Printed 6 1985 



GETC(3S) 


GETC(3S) 


NAME 

getc, getchar, fgetc, getw - get character or word from 
stream 

SYNOPSIS 

#include <stdio,h> 

in t getc ( str earn) 

FILE *stream; 

int getchar () 

in t fgetc ( str earn) 

FILE *str earn ; 

int getw ( str earn) 

FILE *stream; 

DESCRIPTION 

Getc returns the next character (i.e.,byte) from the named 
input str earn . It also moves the file pointer, if defined, 
ahead one character in stream . Getc is a macro and there- 
fore cannot be used if a function is necessary; for example, 
one cannot have a function pointer point to it, 

Getchar returns the next character from the standard input 
stream, st d in . As in the case of ge tc , getchar is a macro. 

Fgetc performs the same function as getc , but is a genuine 
function. Fgetc runs more slowly than getc , but takes less 
space per inv o c a t ion, 

Getw returns the next word (i.e,, integer) from the named 
input str earn , The size of a word varies from machine to 
machine. It returns the constant EOF upon end-of-file or 
error, but as that is a valid integer value, f eo f and 
fer ror ( 3S ) should be used to check the success of getw , 
Getw increments the associated file pointer, if defined, to 
point to the next word, Getw assumes no special alignment 
in the file, 

SEE ALSO 

fclose(3S), ferror(3S), fopen(3S), fread(3S), gets(3S), 
put c ( 3S ) , sc an f ( 3S ) , 

DIAGNOSTICS 

These functions return the integer constant EOF at end-of- 
file or upon an error. 


BUGS 

Because it is implemented as a macro, getc treats 
incorrectly a str earn argument with side effects. In partic- 
ular, getc(*f++) doesn^t work sensibly, Fgetc should be 
usedinstead. 
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Because of possible differences in word length and byte ord- 
ering, files written using pu t w are machine-dependent, and 
may not be read using getw on a different processor. 
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NAME 

getcwi - get pathname of current working <iirectory 
SYNOPSIS 

char *getcwd (buf, size) 

char*buf; 

in t size; 

DESCRIPTION 

Getc wd returns a pointer to the current directory pathname. 
The value of size must be at least two greater than the 
length of the pathname to be returned. 

If buf is a NULL pointer, ge tc wd obtains si ze bytes of space 
using m al 1 PC ( 3C ) . In this case, the pointer returned by 
getc w d may be used as the argument in a subsequent call to 
f r ee , 

The function is implemented by using po pen ( 3S ) to pipe the 
output of the pwd ( 1 ) command into the specified string 
space. 

EXAMPLE 

char *cwd, *getcwd(); 


if ((cwd = getcwd((char »)NULL, 64)) == NULL) { 
per ror ( ' ' pwd ’ ' ) ; 
ex i t ( 1 ) ; 

} 

pr in t f ( ' ' % s\n ’ ’ , cwd); 

SEE ALSO 

pwd ( 1 ) , malloc(3C), popen(3S). 

DIAGNOSTICS 

Returns NULL with er r no set if si_^ is not large enough, or 
if an error occurs in a lower-level function. 
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NAME 

getenv - return value for environment name 
SYNOPSIS 

char *getenv (name) 
char *naine; 

DESCRIPTION 

Getenv searches the environment list (see en v iron ( 5 ) ) for a 
string of the form name s val ue , and returns a pointer to the 
value in the current environment if such a string is 
present; otherwise a NULL pointer is returned. 


SEE ALSO 

environ(5) . 
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NAME 

getgrent, getgrgid, getgrnam, setgrent, endgrent - obtain 
group file entry from a group file 

SYNOPSIS 

#include <grp.h> 

struct group •getgrent ( ) 

struct group »getgrgid (gid) 
in t gid; 

struct group *getgrnam (name) 
char *name; 

void setgrent ( ) 

void endgrent ( ) 

DESCRIPTION 

Getgrent , getgrg id , and getgrnam each return pointers to an 
object with the following structure containing the broken- 
out fields of a line in the /etc/group file. Each line con- 
tains a group structure, defined in the <grp.h> header file. 


struct 

group 

{ 







char 

* gr_nam e ; 

/» 

the 

name of the group •/ 



char 

* gr__pa sswd ; 

/* 

the 

encrypted 

group password 

*/ 


i n t 

gr_gid ; 

/» 

the 

numer ic al 

group ID */ 


}; 

char 

* * gr_^mem ; 

/» 

vector of pointers to member 

names 


When first called, getgrent returns a pointer to the first 
group structure in the file; thereafter, it returns a 
pointer to the next group structure in the file; therefore, 
successive calls may be used to search the entire file, 
Getgrgi d searches from the beginning of the file until a 
numerical group id matching gid is found; it returns a 
pointer to the particular structure in which the match was 
found, Getgrnam searches from the beginning of the file 
until a group name matching name is found; it returns a 
pointer to the particular structure in which the match was 
found. If an end-of-file or an error is encountered on 
reading, these functions return a NULL pointer, 

A call to se tg rent has the effect of rewinding the group 
file to allow repeated searches. Endgrent may be called to 
close the group file when processing is complete. 


FILES 

/ etc / gro up 

SEE ALSO 

ge tlog in ( 3C ) , get pwen t ( 3C ) , group(M), 
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DIAGNOSTICS 

A NULL pointer is returned on EOF or error. 


WARNING 

The above routines use <stdio,h>. This causes them to 
increase the size of programs not otherwise using standard 
I/O more than might be expected. 


BUGS 

All information is contained in a static area, so it must be 
copied if it is to be saved. 
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NAME 

getlogin - get login name 

SYNOPSIS 

char * getlog in ( ) ; 

DESCRIPTION 

Getlogi n returns a pointer ‘to the login name as foun<i in 
/etc/utmp. It may be used in conjunction with ge tpwnam to 
locate the correct password file entry when the same user ID 
is shared by several login names. 

getl o gin is called within a process that is not attached 
to a terminal, it returns a NULL pointer. The correct pro- 
cedure for determining the login name is to call cuser id or 
getlogi n . T f getlogin fails, call getpwuid . 


FILES 

/etc/utmp 
SEE ALSO 

cuserid(3S), g e t g r en t ( 3 C ) , g e t pwen t ( 3 C ) , utmp(4). 
DIAGNOSTICS 

Getlogin returns the NULL pointer if name is not found. 


BUGS 

The return values point to 
overwritten by each call. 


static data whose content is 
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NAME 

getopt - get option letter from argument vector 

SYNOPSIS 

int getopt (argc, argv, optstring) 
in t argc; 
char **argv; 
char *optstring; 

extern char *optarg; 
extern int optind; 

DESCRIPTION 

Ge to pt returns the next option letter in argv that matches a 
letter in optstring . O ptstring is a string of recognized 
option letters; if a letter is followed by a colon, the 
option is expected to have an argument that may or may not 
be separated from it by white space. Opt ar g is set to point 
to the start of the option argument on return from getopt . 

Getopt places in optind the argv index of the next argument 
to be processed. Because optind is external, it is normally 
initialized to zero automatically before the first call to 
getopt , 

When all options have been processed (i,e,, up to the first 
non-option argument), getopt returns EOF, The special 
option -- may be used to delimit the end of the options; EOF 
will be returned, and will be skipped, 

DIAGNOSTICS 

Ge to pt prints an error message on st d er r and returns a ques- 
tion mark (?) when it encounters an option letter not 
included in o pt str ing . 

WARNING 

The above routine uses <stdio.h>. This causes the size of 
programs not otherwise using standard I/O to increase more 
than might be expected, 

EXAMPLE 

The following code fragment shows how one might process the 
arguments for a command that can take the mutually exclusive 
options a and b, and the options f and o, both of which 
require arguments: 

main ( ar gc , argv ) 
int argc ; 
char **argv ; 

{ 

int c ; 

extern int optind; 
extern char *optarg; 
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while ((c = getopt (argc, argv , "abfio:" 
switch ( c) { 
case ’ a ’ : 

if (bflg) 

er r f lg + + ; 

else 

af lg++ ; 
break ; 
case ’ b ’ : 

if (aflg) 

er r f lg++ ; 

else 

bproc ( ) ; 

break ; 
case ’ f ’ ; 

i f i 1 e = opt ar g ; 
break; 
case ’o’; 

ofile = optarg; 
bufsiza = 512; 
break ; 
case’?’: 

err f 1 g + + ; 

} 

if ( err fig ) { 

fprintf (stderr, ’’usage; . . . "); 

exit ( 2 ) ; 

} 

for '( ; optind < argc; optind + +) { 

if (access ( argv [ opt ind ] , U)) { 


} 


!= EOF) 


SEE ALSO 

ge to pt ( 1 ) . 
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NAME 

getpass-reada pass word 

SYNOPSIS 

char •getpass (prompt) 
char * prompt ; 

DESCRIPTION 

Getpass reads up to a newline or EOF from the file /dev/tty, 
after prompting on the standard error output with the null^ 
terminated string prompt and disabling echo. A pointer is 
returned to a null-terminated string of at most 8 charac- 
ters. If /dev/tty cannot be opened, a NULL pointer is 
returned. An interrupt terminates input and sends an inter- 
rupt signal to the calling program before returning. 


FILES 

/ d ev / 1 1 y 

SEE ALSO 

cr ypt ( 3C ) . 


WARNING 

The above routine uses <stdio.h>. This causes the size of 
programs not otherwise using standard I/O to increase more 
than might be expected. 


BUGS 

The return value points to static data whose content is 
overwritten by each call. 
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NAME 

getpw - get name from UTD 
SYNOPSIS 

int getpw (ui-i, buf) 
in t ui d ; 
char *buf; 

DESCRIPTION 

Getpw searches the password file for a user id number that 
equals ui d , copies the line of the password file in which 
ui d was found into the array pointed to by buf , and returns 
0. Getpw returns non-zero if ui d cannot be found. 

This routine is included only for compatibility with prior 
systems and should not be used; see getpwen t ( 3C) for rou- 
tines to use instead. 


FILES 

/etc/passwd 
SEE ALSO 

g e t pwen t ( 3 C ) , passwd(4). 

DIAGNOSTICS 

Getpw returns non-zero on error. 

WARNING 

The above routine uses <stdio.h>. Therefore, the size of 
programs not otherwise using standard I/O is increased more 
than might be expected. 
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NAME 

getpweiit, getpwuid, getpwnam, setpwent, endpwent - get pass- 
word file entry 

SYNOPSIS 

finclude <pwd .h> 

struct passwd *getpwent ( ) 

struct passwd *getpwuid (uid) 
in t uid; 

struct passwd *getpwnam (name) 
char *name; 

void setpwent ( ) 

void endpwent ( ) 

DESCRIPTION 

Ge t pwen t , g e t pwu i d , and g et pwn am each return a pointer to an 
object with the following structure containing the broken- 
out fields of a line in the /etc/passwd file. Each line in 
the file contains a pa sswd structure, declared in the 
<pwd ,h> header file: 

struct passwd { 

char *pw__name; 
char *pw__passwd; 
int pw_uid ; 
int pw_gid; 
char *pw_age; 
char * pw__commen t ; 
char *pw_gecos; 
char * pw__d ir ; 
c har * pw^shel 1 ; 

}; 

struct comment { 

char * c__d ept ; 
char * c^name ; 
char *c__acct; 
char *c bin; 

}; 

Because this structure is declared in <pwd,h>, it is not 
necessary to redeclare it. 

The pw comment field is unused; the others have meanings 
described in pa sswd ( 4 ) . 

When first called, getpwent returns a pointer to the first 
pa sswd structure in the file; thereafter, it returns a 
pointer to the next passwd structure in the file; therefore. 
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successive calls can be used to search the entire file, 
Ge t pwu i d searches from the beginning of the file until a 
numerical user id matching ui d is found; it returns a 
pointer to the particular structure in which the match was 
found. Ge t p wn am searches from the beginning of the file 
until a login name matching name is found; it returns a 
pointer to the particular structure in which the match was 
found. If an end-of-file or an error is encountered on 
reading, these functions return a NULL pointer. 

A call to se t pwen t has the effect of rewinding the password 
file to allow repeated searches. End pwen t may be called to 
close the password file when processing is complete. 

FILES 

/etc/passwd 
SEE ALSO 

g e tl og i n ( 3C ) , getgrentC 3C) , passwd(4). 

DIAGNOSTICS 

A NULL pointer is returned on EOF or error. 

WARNING 

The above routines use <stdio.h>. Therefore the si ze of pro- 
grams not otherwise using standard I/O is increased more 
than might be expected, 

BUGS 

All information is contained in a static area, so it must be 
copied if it is to be saved. 
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NAME 

gets, fgets - get a string from a stream 
SYNOPSIS 

finclude <stdio.h> 

char *gets (s) 
char * s ; 

char *fgets (s, n, stream) 
char *s; 
in t n ; 

FILE *stream; 

DESCRIPTION 

Gets reads characters from the standard input stream, st d in , 
into the array pointed to by s, until a new-line character 
is read or an end-of-file condition is encountered. The 
new-line character is discarded and the string is terminated 
with a null character. 

Fgets reads characters from the str earn into the array 
pointed to by _s until n*" characters are read, or a new-line 
character is read and transferred to _s, or an end-of-file 
condition is encountered. The string is then terminated 
with a null character. 

SEE ALSO 

ferror(3S), fopen(3S), fread(3S), getc(3S), scanf(3S). 
DIAGNOSTICS 

If end-of-file is encountered and no characters have been 
read, no characters are transferred to £ and a NULL pointer 
is returned. If a read error (e.g., trying to use these 
functions on a file that has not been opened for reading) 
occurs, a NULL pointer is returned. Otherwise £ is 
returned . 
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NAME 

getutent, getutid, getutline, pututline, setutent, endutent, 
utmpname - access utmp file entry 

SYNOPSIS 

linclude <utmp.h> 

struct utmp *getutent ( ) 

struct utmp *getutid (id) 
struct utmp • id ; 

struct utmp *getutline (line) 
struct utmp *line; 

void pututline (utmp) 
struct utmp *utmp; 

void setutent ( ) 

void endutent ( ) 

void utmpname (file ) 
char *file; 

DESCRIPTION 

Getutent , g e t ut i d , and getutl ine each return a pointer to a 
structure of the following type; 

struct utmp { 

char ut__user [ 8 ] ; 

char ut__id [ 4 ] ; 

char ut_line[12]; 

short ut__pid; 

short ut__type ; 

struct e X i t___st a t us { 

short e__term in a tion ; 

short e__exit; 

} ut^ex it; 

time__t ut time; 

}; 

Getutent reads in the next entry fro 
the file is not already open, it opens it. If it reaches 
the end of the file, it fails. 

Ge tut id searches forward from the current point in the utmp 
file until it finds an entry with a ut type matching 
id^> ut type if the type specified is FUN^LVL, BOOT_TIME, 
OLD__TIME, or NEW__TIME. If the type specified in is 
INTT_PPOCESS , LOGIN_PROCESS , USEF^PROCESS , or DEAD_PROCESS , 
getut id will return a pointer to the first entry whose type 
is one of these four and whose ut id field matches 


User login name */ 
/etc/inittab id (usually lin 
device name (console, Inxx) 
process id */ 
type of entry */ 


Process termination status * 
Process exit status */ 

The exit status of a process 
marked as DEAD__PROCESS . 
time entry was made */ 


m a JJtm£-like file. If 
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id.r.> ut id . G e t u t i d fails if the end of file is reached 
wi tho ut a match . 

Getutline searches forward from the current point in the 
utmp file until it finds an entry of the type LOGIN__PROCESS 
or USER^PPOCESS which also has a ut line string matching the 
line ^> ut line string. If the end of file is reached without 
a match , it fails . 

Put ut line writes out the supplied utmp structure into the 
utmp file. It uses g e tut i d to search forward for the proper 
place if it finds that it is not already at the proper 
place. It is assumed that the user of pututline has 
searched for the proper entry using one of the g e t ut rou- 
tines. If this has been done, put utl ine will not search. 
If pututline does not find a matching slot for the new 
entry, it will add a new entry to the end of the file. 

Se t u t en t resets the input stream to the beginning of the 
file. This should be done before each search for a new 
entry if it is desired that the entire file be examined. 

End ut en t closes the currently open file. 

Utmpn am e allows the user to change the name of the file 
examined from /etc/utmp to any other filename. It is 
expected that most often this other file will be /etc/wtmp. 
If the file doesn’t exist, this will not be apparent until 
the first attempt to reference the file is made. Utmpname 
does not open the file. It just closes the old file, if it 
is currently open, and saves the new filename. 


FILES 

/etc/utmp 
/ etc/wtmp 

SEE ALSO ’ 

ttyslot(3C), utmp(4). 

DIAGNOSTICS 

A NULL pointer is returned upon failure to read or write. 
Failure to read may be due to permissions or because end-, 
of-file has been reached. 

COMMENTS 

The most current entry is saved in a static structure. Mul- 
tiple accesses require that it be copied before further 
accesses are made. Each call to either getut id or getutline 
sees the routine examine the static structure before per- 
forming more I/O. If the search of the static structure 
results in a match, no further search is performed. To use 
getutline to search for multiple occurences, zero out the 
static structure after each success; otherwise getutline 
will just return the same pointer over and over again. 
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There is one exception to the rule about removing the struc- 
ture before further reads are done. If the implicit read 
done by pututline finds that it isn’t already at the correct 
place in the file, the contents of the static structure 
returned by the g e t ut en t , get ut i d , or ge tutl ine routines are 
not harmed, if the user has just modified those contents and 
passed the pointer back to pututline . 

These routines use buffered standard I/O for input, but 
pututl ine uses an unbuffered non-standard write to avoid 
race conditions between processes trying to modify the utm p 
and wtmp files. 
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NAME 

h search, h create, h destroy - manage hash search tables 
SYNOPSIS 

linclude <search.h> 

ENTRY *hsearch (item, action) 

ENTRY item; 

ACTION action; 

int hcreate (nel) 
unsigned nel; 

void hdestroy ( ) 

DESCRIPTION 

Hse ar c h is a hash-table search routine generalized from 
Knuth (6,4) Algorithm D, It returns a pointer into a hash 
table indicating the location at which an entry can be 
found. Item is a structure of type ENTRY (defined in the 
<search.h> header file) containing two pointers. Item . key 
points to the comparison key and item . data points to any 
other data to be associated with that key, (Pointers to 
types other than character should be cast to pointer-to- 
character.) Action is a member of an enumeration type 
ACTION, indicating the disposition of the entry if it cannot 
be found in the table. ENTER indicates that the item should 
be inserted in the table at an appropriate point. FIND 
indicates that no entry should be made. Unsuccessful reso- 
lution is indicated by the return of a NULL pointer. 

Hcreate allocates sufficient space for the table and must be 
called before h s e a r c h is used. Nel is an estimate of the 
maximum number of entries that the table will contain. This 
number may be adjusted upward by the algorithm in order to 
obtain certain mathematically favorable circumstances. 

Hd estroy destroys the search table and may be followed by 
another call to hcreate. 


NOTES 

Hse arch uses open add ressing with a multiplicative hash 
function. However, many other options are available in the 

source code. The user may select an option by compiling the 

hse ar ch source with the following symbols defined to the 
preprocessor : 

DIV Use the r emaind er modulo table si ze as the 

hash function instead of the multiplicative 
algor i thm , 

USCR Use a User Supplied Comparison Routine for 

ascertaining table membership. The routine 
should be named hcompar and should behave in a 
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mannner similar to st r cmp (see string (3C)) . 

CHAINED Use a linked list to resolve collisions. If 
this option is selected, the following other 
options become available. 

START Place new entries at the beginning 

of the linked list (default is at 
the end ) . 

SORTUP Keep the linked list sorted by key 
in ascending order. 

SORTDOWN Keep the linked list sorted by key 
in descending order. 

Additionally, there are preprocessor flags for obtaining a 
debugging printout (--DDEBUG) and for including a test driver 
in the calling routine (-DDRIVER). The source code should 
be consulted for further details, 

SEE ALSO 

bsearch(3C), lsearch(3C), string(3C), tsearch(3C). 
DIAGNOSTICS 

H s e a r c h returns a NULL pointer if either the action is FIND 
and the item could not be found or the action is ENTER and 
the table is full . 

Her eate returns zero if it cannot allocate sufficient space 
for the table. 

BUGS 

Only one hash search table may be active at any given time. 
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NAME 

hypot - Euclidean distance function 
SYNOPSIS 

linclude <niath.h> 

double hypot (x, y) 
double X , y ; 

DESCPIPTION 

Hypot returns the following, taking 
unwarranted overflows; 

sqrt(x * X + y * y) 


DIAGNOSTICS 

When the correct value would overflow, 
and sets errno to ERANGE. 


These er r or-r-hand 1 ing procedures may be 
function matherr (3M) . 

SEE ALSO 

matherr(3M), sqrt(3F). 


precautions against 


hypot returns HUGE 

changed with the 
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NAME 

13 tol, ltol3 *“ convert between 3'-t)yte integers and long 
integers 

SYNOPSIS 

void 13 tol (Ip, cp, n) 
long «lp; 
char * c p ; 
i n t n ; 

voidltol3(cp,lp,n) 
char •cp; 
long •Ip; 
in t n ; 

DESCRIPTION 

L 3to 1 converts a list of n 3*~t)yte integers (packed into a 
character string pointed to by c_p) into a list of long 
integers pointed to by 1 p . 

L t o 1 3 performs the reverse conversion from long integers 
(Ip) to 3-byte integers ( cp) . 

These functions are useful for file system maintenance where 
the block numbers are 3 bytes long. 

SEE ALSO 

fs(i4). 


BUGS 

Because, of possible differences in byte ordering, the numer- 
ical values of the long integers are machine-dependent; 
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NAME 

IdahreaH -- read the archive header of a member of an archive 
file 


SYNOPSIS 

linclude 
# inc 1 ud e 
j? inc 1 ud e 
P includ e 


<stdio.h> 

< ar . h> 

< f i 1 ehd r . h> 
< Id fen , h> 


int Idahread (Idptr, arhead) 
LDFILE »ldptr; 

APCHDR »arhead; 


DESCRIPTION 

If TYPE ( Id pt r ) is the archive file magic number, Idahread 
reads the archive header of the common object file currently 
associated with Idptr into the area of memory beginning at 
_^_h_e_a d^ . 

Ld ahr ead returns SUCCESS or FAILURE. Ld ahr e ad fails if 
TYPE( ldptr ) does not represent an archive file or if it can- 
not read the archive header. 

The program must be loaded with the object file access rou- 
tine library libld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), ldfcn(4). 
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NAME 

IHclose, Idaclose - close a common object file 

SYNOPSIS 

linclude <stdio.h> 

<finclude <filehdr.h> 

Jl^include <ldfcn.h> 


in t Id close ( Id ptr ) 

LDFILE »ldptr; 

int Idaclose (Idptr) 

LDFILE »ldptr; 

DESCRIPTION 

Ld open ( 3X ) and Id c 1 o se are designed to provide uniform 

access to both simple object files and object files that are 

members of archive files. Thus an archive of common object 
files can be processed as if it were a series of simple com- 
mon object f i 1 es . 

If TYPE( ldpt r) does not represent an archive file, Id c 1 ose 
closes the file and frees the memory allocated to the LDFILE 
structure associated with Id ptr . If TYPE ( Idptr ) is the 

magic number of an archive file, and if there are any more 

files in the archive. Id close reinitializes OFFSET ( Id ptr ) to 
the file address of the next archive member and returns 
FAILURE. The LDFILE structure is prepared for a subsequent 
1 d o pen ( 3X ) . In all other cases. Id cl ose returns SUCCESS. 

Ldac lose closes the file and frees the memory allocated to 
the LDFILE structure associated with Idptr regardless of the 
value of TYPE ( Id ptr ) . Ldaclose always returns SUCCESS. The 
function is often used in conjunction with 1 d ao pe n . 

The program must be loaded with the object file access rou- 
tine library libld.a. 

SEE ALSO 

fclose(3S), ldopen(3X), ldfcn(4). 
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NAME 

Id Thread - read the file header of a common object file 
SYNOPSIS 

linclude <stdio.h> 

^include <filehdr.h> 

Jl^include <ldfcn.h> 


int Idfhread (Idptr, filehead) 

LDFILE «ldptr; 

FILHDR »filehead; 

DESCRIPTION 

Id f hr ea d reads the file header of the common object file 
currently associated with Idptr into the area of memory 
beginning at filehead . 

Ld fhr ea d returns SUCCESS or FAILURE. Ld fhr ead fails if it 
cannotreadthefileheader. 

In most cases the use of 1 d fhr e ad can be avoided by using 
the macro HEADER ( Id ptr ) defined in <ldfcn.h> (see Id f c n ( ^ ) ) . 
The information in any field, f i e Id nam e , of the file header 
may be accessed using HEADER( ldptr ) . fieldname . 

The program must be loaded with the object file access rou- 
tine library libld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), ldfcn(4). 
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NAME 

Idgetname - retrieve symbol name for object file symbol 
t ab 1 e en tr y 

SYNOPSIS 

#include <stdio.h> 
l?include <filehdr.h> 

^include <syms.h> 
ifinclude <ldfcn.h> 

char Idgetname (Idptr, symbol) 

LDFILE Idptr; 

SYMENT symbol ; 

DESCRIPTION 

Ldgetname returns a pointer to the name associated with sym- 
bol as a string. The string is contained in a static buffer 
local to Idgetname. Because the buffer is overwritten by 
each call to 1 d g e tn am e , it must be copied by the caller if 
the name is to be saved. 

The common object file format has been extended to handle 
arbitrary length symbol names with the addition of a "string 
table". Ldgetname returns the symbol name associated with a 
symbol table entry for either an object file or a pre-object 
file. Thus, 1 d g e tn am e can be used to retrieve names from 
object files without any backward compatibility problems. 
Ldgetname returns NULL (defined in <stdio.h>) for an object 
file if the name cannot be retrieved. This occurs when: 


the string table cannot be found. 

not enough memory can be allocated for the string 
table. 

the string table appears not to be a string table 
(e.g., if an auxiliary entry is handed to Idg etname 
that looks like a reference to a name in a non- 
existent string table). 

the name's offset into the string table is beyond 
the end of the string table. 


Typically, Id g etnam e is called immediately after a success- 
ful call to Id thread to retrieve the name associated with 
the symbol table entry filled by Id tb r ead . 

The program must be loaded with the object file access rou- 
tine library libld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), Id tb seek ( 3X ) , Id thread ( 3X) , 
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NAME 

I'^lrea'i, Idlinit, Idlitem - manipulate line number entries 
of a common object file function 


SYNOPSIS 

# incl ud e 
# inc 1 ud e 
inc 1 ud e 
# incl ud e 


<std io .h> 

< f i 1 ehd r . h> 
<linenum .h> 
< Id f cn . h> 


int Idlread (Idptr, fcnindx, linenum, linent) 

LDFILE »ldptr; 

long fcnindx; 

unsigned short linenum; 

LINENO linent; 

intldlinit(ldptr, fcnindx) 

LDFILE »ldptr; 
long fcnindx; 

int Idlitem (Idptr, linenum, linent) 

LDFILE »ldptr; 
unsigned short linenum; 

LINENO 1 inent ; 

DESCRIPTION 

Ld 1 r ead searches the line number entries of the common 
object file currently associated with Idptr . Ld Ir ead begins 
its search with the line number entry for the beginning of a 
function and confines its search to the line numbers associ- 
ated with a single function. The function is identified by 
fcnindx , the index of its entry in the object file symbol 
table. Ld 1 r e ad reads the entry with the smallest line 
number equal to or greater than 1 in en urn into linen t. 

Ld 1 in i t and Idlite m together perform exactly the same func- 
tion as Idlread . After an initial call to Id Iread or 
Id 1 1 n i t , I dlitem m.ay be used to retrieve a series of line 
number entries associated with a single function. Ld 1 in i t 
simply locates the line number entries for the function 
identified by fcnindx . Ld 1 i tern finds and reads the entry 
with the smallest line number equal to or greater than line- 
num into linent . 

Ld 1 r e ad , Id 1 in i t , and Id 1 i tern each return either SUCCESS or 
FAILURE. Ld I r e ad fails if there are no line number entries 
in the object file, if fcnindx does not index a function 
entry in the symbol table, or if it finds no line number 
equal to or greater than linenum . L d 1 i n i t fails if there 
are no line number entries in the object file or if fcnindx 
does not index a function entry in the symbol table. Ld 1 i - 
tern fails if it finds no line number equal to or greater 
than linenum. 
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The programs must be loa<ied with the object file access rou-- 
tine library libld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), Id tb ind ex ( 3X ) , Idfcn(M). 
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NAME 

Idlseek, Idnlseek - seek to linp number entries of a section 
of a common object file 

SYNOPSIS 

linclude <stdio,h> 

^include <filehdr.h> 

^include <ldfcn.h> 

int Idlseek (Idptr, sectindx) 

LDFILE »ldptr; 
unsigned short sectindx; 

int Idnlseek (Idptr, sectname) 

LDFILE * Id pt r ; 
char *sectname; 

DESCRIPTION 

L d 1 s e e k seeks to the line number entries of the section 
specified by sectindx of the common object file currently 
associated with Idptr . 

Ijinlseek seeks to the line number entries of the section 
specified by sectname . 

L d 1 se e k and Idnlseek return SUCCESS or FAILURE. Ld 1 see k 
fails if sectindx is greater than the number of sections in 
the object file; Idnlseek fails if there is no section name 
corresponding to * se c tn ame . Either function fails if the 
specified section has no line number entries or if it cannot 
seek to the specified line number entries. 

Note that the first section has an index of one . 

The program must be loaded with the object file access rou- 
tine library libld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), Id shr ead ( 3X ) , ldfcn(4). 
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NAME 

Idohseek seek to the optional file header of a common 
object file 

SYNOPSIS 

linclude <stdio.h> 
i?include <filehdr.h> 

^include <ldfcn.h> 

int Idohseek (Idptr) 

LDFILE •idptr; 

DESCRIPTION 

Ido hseek seeks to the optional file header of the common 
object file currently associated with Idptr . 

Ldohseek returns SUCCESS or FAILURE. Ldohseek fails if the 
object file has no optional header or if it cannot seek to 
theoptional header. 

The program must be loaded with the object file access rou- 
tine library libld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), Id fhr ead ( 3X ) , ldfcn(4). 
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NAME 

Idopen, Idaopen - open a common object file for reading 
SYNOPSIS 

linclude <stdio.h> 

^include <filehdr.h> 
i^include <ldfcn.h> 

LDFILE *ldopen (filename, Idptr) 
char *filename; 

LDFILE «ldptr; 

LDFILE •idaopen (filename, oldptr) 
char *filename; 

LDFILE »oldptr; 

DESCRIPTION 

L d o p e n and ldcIose (3X) are designed to provide uniform 
access to both simple object files and object files that are 
members of archive files. Thus, an archive of common object 
files can be processed as if it were a series of simple com- 
mon object files. 

If Idptr has the value NUll , Idopen opens f i 1 en am e , allo- 
cates and initializes the LDFILE structure, and returns a 
pointer to the structure to the calling program. 

If Id pt r is valid and TYPE ( Id ptr ) is the archive magic 
number, Idopen reinitializes the LDFILE structure for the 
next archive member of f i 1 ename . 

Ld open and Id close are designed to work in concert. Ld cl ose 
returns FAILURE only when TYPE ( Idptr ) is the archive magic 
number and there is another file in the archive to be pro- 
cessed. Only then should Idopen be called with the current 
value of Idptr . In all other cases, in particular whenever 
a new filename is opened, Id open should be called with a 
NULL Idptr argument . 

The following is a prototype for the use of Idopen and 
Id close . 
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/* for each filename to be processed * / 

Idptr = NULL; 
do 

if ( (Idptr = Id open ( f i 1 en am e , Idptr)) != NULL ) 

{ 

/* check magic number 
/* process the file •/ 

} 

} while ( Id cl ose ( Id pt r ) == FAILURE ); 

If the value of ol d pt r is not NULL, Id ao pen opens f i 1 en am e 
anew and allocates and initializes a new LDFILE structure, 
copying the TYPE, OFFSET, and HEADER fields from ol d pt r . 
Ld ao pen returns a pointer to the new LDFILE structure. This 
new pointer is independent of the old pointer, ol d pt r . The 
two pointers may be used concurrently to read separate parts 
of the object file. For example, one pointer may be used to 
step sequentially through the relocation information, while 
the other is used to read indexed symbol table entries. 

Both Id ope n and Id aopen open f i 1 en am e for reading. Both 
functions return NULL if f i 1 en am e cannot be opened or if 
memory for the LDFILE structure cannot be allocated, A suc^ 
cessful open does not insure that the given file is a common 
object file or an archived object file. 

The program must be loaded with the object file access rou^ 
tine library libld.a. 

SEE ALSO 

fopen(3S), ldclose(3X), ldfcn(4). 
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NAME 

Idrseek, Idnrseek - seek to relocation entries of a section 
of a common object file 

SYNOPSIS 

finclude <stdio.h> 
linclude <filehdr.h> 

#include<ldfcn.h> 

int Idrseek (Idptr, sectindx) 

LDFILE «ldptr; 
unsigned short sectindx; 

int Idnrseek (Idptr, sectname) 

LDFILE »ldptr; 
char *sectname; 

DESCRIPTION 

Ldr seek seeks to the relocation entries of the section 

specified by sectindx of the common object file currently 
associated with Idptr . 

Ldnr seek seeks to the relocation entries of the section 

specified by sectname . 

Ld r seek and ldnr seek return SUCCESS or FAILURE. Ldr seek 
fails if sectindx is greater than the number of sections in 
the object file; ldnr seek fails if there is no section name 
corresponding with sectname . Either function fails if the 
specified section has no relocation entries or if it cannot 
seek to the specified relocation entries. 

Note that the first section has an index of one . 

The program must be loaded with the object file access rou- 
tine library libld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), Id shr ead ( 3X ) , ldfcn(4). 
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NAME 

Idshread, Idnshreafi - read an ind ex ed /named section header 
of a common object file 

SYNOPSIS 

#include <stdio.h> 
iinclude <filehdr.h> 
iinclude <scnhdr.h> 
finclude <ldfcn.h> 

int Idshread (Idptr, sectindx, secthead) 

LDFILE »ldptr; 
unsigned short sectindx; 

SCNHDR •secthead; 

int Idnshread (Idptr, sectname, secthead) 

LDFILE •Idptr; 
char sectname; 

SCNHDR •secthead; 

DESCRIPTION 

Ld shr ead reads the section header specified by sectindx of 
the common object file currently associated with Id ptr into 
the area of memory beginning at secthead . 

Ldnshr ead reads the section header specified by sec tnam e 
into the area of memory beginning at secthead . 

Ld shr ead and Idnshread return SUCCESS or FAILURE. Ld shr ead 
fails if sectindx is greater than the number of sections in 
the object i^ile; Idnshread fails if there is no section name 
corresponding with sectname . Either function fails if it 
cannot read the specified section header. 

Note that the first section header has an index of one . 

The program must be loaded with the object file access rou- 
tine library libld.a. 

SEE ALSO 

IdcloseOX). IdopenOX). Idfcn(M). 
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NAME 

Idsseek, Irinsseek - seek to an indexed/named section of a 
common object file 

SYNOPSIS 

# includ e < std io .h> 

^include <filehdr.h> 

/^include <ldfcn.h> 

int Idsseek (Idptr, sectindx) 

LDFILE »ldptr; 
unsigned short sectindx; 

int Idnsseek (Idptr, sectname) 

LDFILE »ldptr; 
char * sec tn ame ; 

DESCRIPTION 

Ld sse e k seeks to the section specified by sectindx of the 
common object file currently associated with Idptr . 

Ldns seek seeks to the section specified by sec tn am e . 

Ld sseek and Idnsseek return SUCCESS or FAILURE. Ld ssee k 
fails if sectindx is greater than the number of sections in 
the object file; Idnsseek fails if there is no section name 
corresponding with sectname . Either function fails if there 
is no section data for the specified section or if it cannot 
seek to the specified section. 

Note that the first section has an index of one . 

The program must be loaded with the object file access rou- 
tine library libld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), Id shr ead ( 3X ) , ldfcn(4). 
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NAME 

Idtbindex - compute the index of a symbol table entry of a 
common object file 

SYNOPSIS 

linclude <stdio.h> 

^include <filehdr.h> 

^include <syms.h> 

#include <ldfcn.h> 

long Idtbindex (Idptr) 

LDFILE »ldptr; 

DESCRIPTION ■ 

Ld t b ind e x returns the (long) index of the symbol table entry 
at the current position of the common object file associated 
with . 

The index returned by Idtbindex may be used in subsequent 
calls to ldtbread (3X) . However, since Idtbindex returns the 
index of the symbol table entry that begins at the current 
position of the object file, if Idtbindex is called immedi- 
ately after a particular symbol table entry has been read, 
it returns the the index of the next entry. 

Ld t b i nd ex fails if there are no symbols in the object file 
or if the object file is not positioned at the beginning of 
a symbol table entry. 

Note that the first symbol in the symbol table has an index 
o f _zer^ . 

The program must be loaded with the object file access rou- 
tine library libld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), Id thread ( 3X ) , Id tbseekC 3X ) , 
ldfcn(4). 
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NAME 

Idtbread - read an indexed symbol table entry of a common 
object file 

SYNOPSIS 

linclude <stdio.h> 

^include <filehdr.h> 
ilinclude <syms,h> 
ii*include <ldfcn.h> 

int Idtbread (Idptr, symindex, symbol) 

LDFILE »ldptr; 
long sym index; 

SYMENT »symbol; 

DESCRIPTION 

Ldtbread reads the symbol table entry specified by symindex 
of the common object file currently associated with Idptr 
into the area of memory beginning at symbol . 

Ldtbread returns SUCCESS or FAILURE. Ld thread fails if s ym^ 
index is greater than the number of symbols in the object 
file or if it cannot read the specified symbol table entry. 

Note that the first symbol in the symbol table has an index 
o f _^r;^ . 

The program must be loaded with the object file access rou^ 
tine library libld.a. 

SEE ALSO 

ldclose(3X), IdgetnameC 3X ) , ldopen(3X), Id tb seek( 3X ) , 
Id fcn( 4 ) . 
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NAME 

Idtbseek - seek to the symbol table of a common object file 
SYNOPSIS 

#include<stdio.h> 

^include <filehdr.h> 
i^include <ldfcn.h> 

int Idtbseek (Idptr) 

LDFILE «ldptr; 

DESCRIPTION 

Idtbseek seeks to the symbol table of the object file 
currently associated with Idptr . 

Ldtbseek returns SUCCESS or FAILURE. Idtbseek fails if the 
symbol table has been stripped from the object file or if it 
cannot seek to the symbol table. 

The program must be loaded with the object file access rou- 
tine library libld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), Id tb r e ad ( 3X ) , ldfcn(4). 
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NAME 

logname - return login name of user 


SYNOPSIS 

char •logname( ) 


DESCRIPTION 

Logname returns a pointer to the null-terminated login name; 
it extracts the $LOGNAME variable from the user’s environ- 
ment. 

This routine iskept in /lib/lib PW. a. 


FILES 

/etc/ pro file 

SEE ALSO 

env(1), login(l), profileCM), environ(5). 

BUGS 


The return values point to static data whose content is 
overwritten by each call. 

This method of determining a login name is subject to for- 
gery. 
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NAME 

Isearch - linear search anrl update 

SYNOPSIS 

char *lsearch ((char *)key,(char *)base, nelp, si zeo f ( * ke y ) , 
compar 

unsigned •nelp; 
in t (• compar )() ; 

DESCRIPTION 

Lse ar c h is a linear search routine generalized from Knuth 
(6.1) Algorithm S. It returns a pointer into a table indi- 
cating where data may be found. If the data does not occur, 
it is added at the end of the table. Key points to the data 
to be sought in the table. Base points to the first element 
in the table. Nelp points to an integer containing the 
current number of elements in the table. The integer is 
incremented if the data is added to the table. Co m pa r is 
the name of the comparison function which the user must sup- 
ply ( St r cmp , for example). It is called with two arguments 
that point to the elements being compared. The function 
must return zero if the elements are equal and non-zero oth- 
erwise. 


NOTES 

The pointers to the key and the element at the base of the 
table should be of type pointer-to-el ement and cast to type 
po in ter- to-char ac ter . 

The comparison function need not compare every byte, so 
arbitrary data may be contained in the elements in addition 
to the values being compared. 

Although declared as type po in ter-to-char ac ter , the value 
returned should be cast into type pointer-to-el ement . 

SEE ALSO 

bsearch(3C), hsearch(3C), tsearch(3C). 


BUGS 

Undefined results can occur if there is not enough room in 
the table to add a new item. 


- 1 - 


Printed 6 1985 



MALL0C(3C) 


MALL0C(3C) 


NAME 

malloc, free, realloc, calloc - main memory allocator 
SYNOPSIS 

char *malloc (size) 
unsigned size; 

void free (ptr) 
char *ptr; 

char *realloc (ptr, size) 
char •ptr; 
unsigned size; 

char •calloc (nelera, elsize) 
unsigned nelem, elsize; 

DESCRIPTION 

H a 1 1 o c and f r ee provide a simple general-purpose memory 
allocation package, Malloc returns a pointer to a block of 
at least bytes suitably aligned for any use. 

The argument to f r ee is a pointer to a block previously 
allocated by malloc ; after free is performed this space is 
made available for further allocation, but its contents are 
1 e f t und i s t ur b ed , 

Undefined results occur if the space assigned by malloc is 
overrun or if some random number is handed to free . 

Malloc allocates the first contiguous reach of free space of 
sufficient size found in a circular search from the last 
block allocated or freed; it coalesces adjacent free blocks 
as it searches. It calls sb r k (see br k ( 2 ) ) to get more 
memory from the system when there is no suitable space 
already free. 

Pe alloc changes the size of the block pointed to by ptr to 
si ze bytes and returns a pointer to the (possibly moved) 
block. The contents are unchanged up to the lesser of the 
new and old sizes. If no free block of size bytes is avail-r- 
able in the storage arena, r e al 1 oc asks m alloc to enlarge 
the arena by size bytes and then moves the data to the new 
space. 

Re a 1 1 oc also works if ptr points to a block freed since the 
last call of malloc , r e al 1 oc , o r calloc ; thus sequences of 
fr ee , malloc , and r e al 1 oc can exploit the search strategy of 
malloc to do storage compaction. 

Calloc allocates space for an array of n el em elements of 
size elsize. The space is initialized to zeros. 
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Each of the allocation routines returns a pointer to space 
suitably aligned (after possible pointer coercion) for 
storage of any type of object. 

DIAGNOSTICS 

Ma 1 1 PC , r e al 1 PC , and c al 1 oc return a NULL pointer if there 
is no available memory or if the arena has been detectably 
corrupted by storing outside the bounds of a block. When 
this happens the block pointed to by pt r may be destroyed. 


NOTE 

Search time increases when many objects have been allocated; 
i.e., if a program allocates space but never frees it, each 
successive allocation takes longer. 
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NAME 

math err - error-handling function 


SYNOPSIS 

#include <math.h> 

int matherr (x) 
struct exception •x; 


DESCRIPTION 

Matherr is invoked by functions in the Math Library when 
errors are detected. Users may define their own procedures 
for handling errors by including a function named matherr in 
their programs, Ma ther r must be of the form described 
above, A pointer to the exception structure £ will be 
passed to the user- suppl ied matherr function when an error 
occurs. This structure, which is defined in the <inath.h> 
header file, is as follows: 


struct exception { 
int type ; 
char *name; 

double argi, arg?, retval; 

}; 


The element type is an integer describing the type of error 
that has occurred; one of the following constants (defined 
in the header file) is used: 


DOMAIN 

SING 

OVEPFLOW 

UNDERFLOW 

TLOSS 

PLOSS 


domain error 
singularity 
over flow 
under flow 

total loss of significance 
partial loss of significance 


The element name points to a string containing the name of 
the function that had the error. The variables argi and 
arg? are the arguments to the function that had the error, 
P e t V al is a double that is returned by the function having 
the error. If it supplies a return value, the user’s math- 
err must return non-zero. If the default error value is to 
be returned, the user’s m atherr must return 0. 

^ a is not supplied by the user, the default error- 
handling procedures, described with the math functions 
involved, will be invoked upon error. These procedures are 
summarized in the table following the exam. pie below. In 
every case, er r no is set to non-zero and the program contin- 
ue s . 

EXAMPLE 
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rratherr(x) 

register struct exception *x; 

{ 

switch (x->type) { 
case DOMAIN ; 

case SING: /* print message and abort */ 

fprintfCstderr, "domain error in ?s\n", x->name); 
abor t ( ) ; 

case OVERFLOW: 

if (!strGmp("exp",x->name)) { 

/* if exp, print message, return the argument •/ 
f pr in t f ( stderr , "exp of 5tf\n", x->arg1); 
x->retval = x->arg1; 

} else if ( ! strcmpC " si nh" , x->name) ) { 

/* if sinh, set errno, return 0 */ 
errno = ERANGE; 
x->retval = 0; 

} else 

otherwise, return HUGE */ 
x->retval = HUGE; 
break; 

case UNDERFLOW: 

return (0); /* execute default procedure •/ 

case TLOSS: 
case FLOSS: 

/* print message and return 0 */ 

fpr intf( stderr , "loss of significance in /6s\n", x->nani 

x->r etval = 0 ; 

break; 

} 

return ( 1 ) ; 

} 
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1 

1 

DEFAULT “e R R 6T 

HANDLING 

PROCEDURES 



1 

1 

1 



Types 

0 f Errors 



1 

1 

DOMAIN 

SING 

OVERFLOW 

underflow' 

TLOSS 

PLOSS 

5e“s5EL: 

- 

- 

1 H 

1 0 

- 

« 

yo , y 1 , yn 

M, -H 

- 

I ^ 

1 _ 

- 

— 

1 ( neg , no , ) 

1 

1 



1 

1 

1 

1 

1 

1 

! 

\ 



exp": 

- 

- 

1 H 

1 0 

- 


fOW : 

- 

- 

1 H 

i 0 

- 

- 

{neg,)**(non- 

M, 0 

- 

1 _ 

1 ^ 

- 

- , 

lint,), 0**0 

1 



1 

1 

I 

1 

1 

1 

1 



E'og : 
log ( 0 ) ; 


M, -H 

1 

1 

I 

1 

1 

1 ^ 



iog (neg , ) : 

M, -H 

- 

1 ^ 

1 ^ 

- 

- 

$QRT : 

1 

1 

M, 0 

— j _ ' 1— 

1 1 

1 1 

— 

— 

(JA'm ma : 

- 

M. H 

1 _ 

1 ^ 

- 

- 

HYPOT : 

1 

1 

— 

— ■ 

i H 

1 

1 

1 ^ 

1 

1 

— 

— 

$INH, COSH: 

- 

- 

1 H 

1 

- 

- 

$IN, COS: 

1 

1 

— 

— 

I ^ 

1 

1 

1 ^ 

1 

1 

M, 0 

M, * 

f A N : 

- 

- 

1 H 

1 ^ 

0 

« 

ACOS, ASIN: 

\ 

1 

M, 0 

— 

I ^ 

t 

1 

1 _ 

1 

1 

— 

— 





ABBREVIATIONS 


! * As much as possible of the value is returned, 

i M Message is printed, 

I H HUGE is returned, 

i ~H -HUGE is returned, 

i 0 0 is returned. 
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NAME 

memccpy, memchr, tnerncmp, memcpy, memset - memory operations 
SYNOPSIS 

linclude <memory.h> 

char •memccpy (si, s2, c, n) 
char *s1, *32; 
in t c , n ; 

char •memchr (s, c, n) 
char •s; 
in t c , n ; 

int memcmp (si, s2, n) 
char •si, * s2; 
i n t n ; 

char *memcpy (si, s2, n) 
char • s 1 , • s2 ; 
int n ; 

char •memset (s, c, n) 
char • s ; 
int c , n ; 

DESCRIPTION 

These functions operate efficiently on memory areas (arrays 
of characters bounded by a count, not terminated by a null 
character). They do not check for the overflow of any 
receiving memory area. 

Memccpy copies characters from memory area ^ into stop-r. 

ping after the first occurrence of character £ has been 
copied or after n characters have been copied, whichever 
comes first. It returns either a pointer to the character 
after the copy of £ in ^ or a NULL pointer if £ was not 
found in the first n characters of s 2 . 

Memchr returns either a pointer to the first occurrence of 
character c in the first n characters of memory area _s or a 
NULL pointer if _c does not occur. 

Mem cm p compares its arguments, looking at the first ri char-o 
acters only. It returns an integer less than, equal to, or 
greater than 0, depending on whether _s2 is lexicographically 
less than, equal to, or greater than s2 . 

Memcpy copies n characters from memory area s2 to _s£. It 
returns £_1 . 

Mem se t sets the first n characters in memory area £ to the 
value of character c. It returns s . 
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NOTE 

For user conv enl enc e , all these functions are declared in 
the optional <rDemory.h> header file. 


BUGS 

Mem c m p uses native character comparison, which is signed on 
PDP-11S, unsigned on other machines. 

Because character movement is performed differently in dif- 
ferent implementations, overlapping moves may yield unex- 
pected results. 
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NAME 

mktemp - make a unique filename 


SYNOPSIS 

char *mktemp (template) 
char*template; 

DESCRIPTION 

Mktemp replaces the contents of the string pointed to by 
template with a unique filename; it returns the address of 
templat e . The string in template should look like a 
filename with six trailing Xs ; mktemp replaces the Xs with a 
letter and the current process ID. The letter is chosen so 
that the resulting name does not duplicate an existing file. 

SEE ALSO 

getpid(2), tmpfile(3S), tmpnam(3S). 

BUGS 

It is possible to run out of letters. 
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NAME 

monitor - prepare execution profile 
SYNOPSIS 

void monitor (lowpc, highpc, buffer, bufsize, nfunc) 

Int (*lowpG)( ), (*highpc)( ); 

short •buffer ; 

int bufsize, nfunc; 

DESCRIPTION 

An executable program created by cc -.p automatically 
includes calls for monitor with default parameters; monitor 
needn't be called explicitly except to gain fine control 
ov er pr o f i 1 ing . 

Monitor is an interface to pr o f i 1 ( 2 ) . Lowpc and h i g h p c are 
the addresses of two functions; buffer is the address of a 
(user supplied) array of bu f si ze short integers. Monit or 
arranges to record a histogram in the buffer. This histo- 
gram shows periodically sampled values of the program 
counter and counts of calls of certain functions. The 
lowest address sampled is that of lowpc ; the highest address 
is just below h i g h p c . L owpc may not equal 0 for this use of 
monitor . N fun c is the maximum number of call counts that 
can be kept; only calls of functions compiled with the pro- 
filing option -p of £c( 1 ) are recorded, (The C Library and 
Math Library supplied when cc -p is used also have call 
counts recorded.) For the results to be significant, espe- 
cially where there are small, heavily used routines, it is 
suggested that the buffer be no more than a few times 
smaller than the range of locations sampled. 

To profile the entire program, it is sufficient to use 

ex tern e tex t ; 

monitor ((int (*)())2, etext, buf, bufsize, nfunc); 

Etex t lies just above all the program text; see end (30. 

To stop execution monitoring and write the results on the 
file non .out , use 

monitor ((int (»)())NULL, 0, 0, 0, 0); 

Prof(1) can then be used to examine the results. 


FILES 

mon .out 
SEE ALSO 

cc(1), prof(1), profil(2), end(3C). 
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NAME 

nlist - get entries from name list 
SYNOPSIS 

linclude <a.out.h> 

int nlist (filename, nl) 
char •filename; 
struct nl i St nl [ ] ; 

DESCPIPTION 

Nlist examines the name list in the executable file whose 
name is pointed to by f i 1 en am e ; it selectively extracts a 
list of values and puts them in the array of nlis t struc- 
tures pointed to by n_l . The name list nl. consists of an 
array of structures containing names of variables, types, 
and values. The list is terminated with a null name; i.e., 
a null string is in the name position of the structure. 
Each variable name is looked up in the name list of the 
file. If the name is found, the type and value of the nam.e 
are inserted in the next two fields. If the name is not 
found, both entries are set to 0. See a . o ut ( M ) for a dis- 
cussion of the symbol table structure. 

This subroutine is useful for examining the system name list 
kept in the file /unix. In this way programs can obtain 
system addresses that are up to date. 

SEE ALSO 

a .out ( M ) . 

DIAGNOSTICS 

All type entries are set to 0 if the file cannot be read or 
if it doesn ’ t conta in a valid name list. 

Nl ist returns -1 upon error; otherwise it returns 0. 
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NAME 

perror, errno, sys^errlist, sys__nerr ^ system error messages 

SYNOPSIS 

void perror ( s) 
char * s ; 

extern int errno; 

extern char • sys^er r 1 i st C ]; 

extern int sys^nerr; 

DESCRIPTION 

Perror produces a message on the standard error output, 
describing the last error encountered during a call to a 
system or library function. The argument string _s is 
printed first, then a colon and a blank, then the message 
and a new-line. To be of most use, the argument string 
should include the name of the program that incurred the 
error. The error number is taken from the external variable 
er rno , which is set when errors occur but not cleared when 
non-erroneous calls are made. 

To simplify variant formatting of messages, the array of 
message strings sys errlist is prov id ed ; errno can be used 
as an index in this table to get the message string without 
the new-line. Sys nerr is the largest message number pro- 
vided for in the table; it should be checked because new 
error codes may be added to the system before they are added 
to the table. 

SEE ALSO 

i n tr o ( 2 ) . 
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NAME 

popen, pclose - initiate pipe to/from a process 

SYNOPSIS 

finclude <stdio.h> 

FILE •popen (command, type) 
char •command, •type; 

int pclose (stream) 

FILE •stream; 

DESCRIPTION 

The arguments to po pen are pointers to nul 1-term in a ted 
strings; one string contains a shell command line and the 
other contains an T/0 mode. The mode may be either r for 
reading or w for writing. creates a pipe between the 

calling program and the command to be executed. The value 
returned is a stream pointer. If the I/O mode is w, one can 
write to the standard input of the command by writing to the 
file stream ; if the I/O mode is r, one can read from the 
standard output of the command, by reading from the file 
stream . 

A stream opened by popen should be closed by pclose , which 
waits for the associated process to terminate and returns 
the exit status of the command. 

Because open files are shared, a type r command may be used 
as an input filter and a type w as an output filter. 

SEE ALSO 

pipe(2), wait(2), fclose(3S), fopen(3S), system(3S). 
DIAGNOSTICS 

Po pen returns a NULL pointer if files or processes cannot be 
created or if the shell cannot be accessed. 

Pclo se returns -1 if stream is not associated with a command 
opened by popen. 


BUGS 

If the original processes and processes opened by popen con- 
currently read or write a common file, neither should use 
buffered I/O, because the buffering gets all mixed up. 
Problems with an output filter may be forestalled by careful 
buffer flushing, e.g., by using f f 1 u s h ; see fclose ( 3S ) . 
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NAME 

printf, fprintf, sprintf - print formatted output 
SYNOPSIS 

#include <stdio,h> 

int printf (format [ , arg ] ... ) 

char ^format; 

int fprintf (stream, format [ , arg ] ,,, ) 

FILE ^stream; 
char * fo rmat ; 

int sprintf (s, format [ , arg ] ... ) 

char * s , f o rm a t ; 

DESCRIPTION 

P rintf places output on the standard output stream st d out . 
Fprintf places output on the named output strea m , S printf 
places ''output’’, followed by the null character (\0) in 
consecutive bytes starting at *s; it is the user’s responsi- 
bility to ensure that enough storage is available. Each 
function returns the num.ber of characters transmitted (not 
including the \0 in the case of sprint f) , or a negative 
value if an output error was encountered. 

Each of these functions converts, formats, and prints its 
ar g s under control of the form at . The format is a character 
string that contains two types of objects: plain characters, 
which are simply copied to the output stream, and conversion 
specifications, each of which results in fetching zero or 
more ar g s . The results are undefined if there are insuffi- 
cient ar g s for the format. If the format is exhausted while 
ar g s remain, the excess ar g s are simply ignored. 


Each conversion specification is introduced by the character 
%. After the %, the following appear in sequence: 

Zero or more flags , which modify the meaning of the 
conversion specification. 

An optional decimal digit string specifying a minimum 
field w idth . If the converted value has fewer charac- 
ters than the field width, it will be padded to the 
field width on the left (default) or right (if the 
left-adjustment flag has been given); see below for 
flag specification. 

^ that gives the minimum number of digits to 
appear for the d, o, u, X, or X conversions, the number 
of digits to appear after the decimal point for the e 
and f conversions, the maximum number of significant 
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digits for the g conversion, or the maxim um number of 
characters to be printed from a string in s conversion. 
The format of the precision is a period (,) followed by 
a decimal digit string; a null digit string is treated 
as zero. 

An optional 1 specifying that a following d, o, u, x, 
or X conversion character applies to a long integer 
ar g . . 

A character that indicates the type of conversion to be 

applied. 

A field width or precision may be indicated by an asterisk 
(•) instead of a digit string. In this case, an integer ar g 
supplies the field width or precision. The ar g that is 
actually converted is not fetched until the conversion 
letter is seen; therefore, the ar g s specifying field width 
or precision must appear b e for e the ar g (if any) to be con- 
verted , 

The flag characters and their meanings are: 

The result of the conversion will be left- 
justified within the field. 

The result of a signed conversion will always 
begin with a sign (+ or -), 

If the first character of a signed conversion is 
not a sign, a blank will be prefixed to the 
result. This implies that if the blank and + 
flags both appear, the blank flag will be ignored. 

This flag specifies that the value is to be con- 
verted to an ''alternate form,’’ For c, d, s, and 
u conversions, the flag has no effect. For o 
conversion, it increases the precision to force 
the first digit of the result to be a zero. For x 
(X) conversion, a non-zero result will have Ox 
(OX) prefixed to it. For e, E, f, g, and G 
conversions, the result will always contain a 
decimal point, even if no digits follow the point 
(normally, a decimal point appears in the result 
of these conversions only if a digit follows it). 
For g and G conversions, trailing zeroes will no t 
be removed from the result (which they normally 
are) . 

The conversion characters and their meanings are; 
d,o,u,x,X The integer ar g is converted to signed decimal. 


blank 
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f 


e , E 


g ,G 


c 

s 


% 


u II signed octal, decimal, or hexadecimal notation 
(x and X), respectively; the letters abcdef are 
used for x conversion and the letters ABCDEF for X 
conversion. The precision specifies the minimum 
number of digits to appear; if the value being 
converted can be represented in fewer digits, it 
will be expanded with leading zeroes. The default 
precision is 1, The result of converting a zero 
value with a precision of zero is a null string. 

The float or double ar g is converted to decimal 
notation in the style ''[-jddd.ddd’’, where the 
number of digits after the decimal point is equal 
to the precision specification. If the precision 
is missing, 6 digits are output; if the precision 
is explicitly 0, no decimal point appears. 

The float or double ar g is converted in the style 
''[-]d,ddde+dd’', where there is one digit before 
the decimal point and the number of digits after 
it is equal to the pr ec i sion ; when the precision 
is missing, 6 digits are produced; if the preci- 
sion is zero, no decimal point appears. The E 
format code produces a number with E instead of e 
introducing the exponent. The exponent always 
contains at least two digits. 

The float or double ar g is printed in style f or e 
(or in style E in the case of a G format code), 
with the precision specifying the number of signi- 
ficant digits. The style used depends on the 
value converted: style e is used only if the 
exponent resulting from the conversion is less 
than -4 or greater than the precision. Trailing 
zeroes are removed from the result; a decimal 
point appears only if it is followed by a digit. 

The character ar g is printed. 

The ar g is taken to be a string (character 
pointer) and characters from the string are 
printed until a null character (\0) is encountered 
or the number of characters indicated by the pre- 
cision specification is reached. If the precision 
is missing, it is taken to be infinite, so all 
characters up to the first null character are 
printed. If the string pointer ar g has the value 
zero, the result is undefined, A null arg yields 
undefined results. 

Print a %\ no argument is converted. 
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In no case does a non-existent or small field width cause 
truncation of a field; if the result of a conversion is 
wider than thefield width, the field is simply expanded to 
contain the conversion result. Characters generated by 
pr in t f and f pr i n t f are printed as if p u t c ( 3 S ) had been 
called . 

EXAMPLES 

To print a date and time in the form ''Sunday, July 3, 
10:02’’, where weekd ay and m onth are pointers to null- 
terminatedstrings: 

printf(”/ts, %s %d, %.2d;J6,2d”, weekday, month, day, hour, min); 
To print to 5 decimal places: 

printf("pi = 1t,5f”, M*atan ( 1 , 0 ) ) ; 

SEE ALSO 

ecvt(3C), putc(3S), scanf(3S), stdio(3S). 
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NAME 

putc , putchar, fputc, putw - put character or word on a 
stream 

SYNOPSIS 

#include <stdio.h> 

int putc (c, stream) 
char c; 

FILE*stream; 

int putchar (c) 
char c ; 

int fputc (c, stream) 
char c; 

FILE •stream; 

int putw (w, stream) 
int w; 

FILE •stream; 

DESCRIPTION 

Putc writes the character c onto the output st r earn at the 
position where the file pointer, if defined, is pointing, 
Put char C c) is defined as putc ( c , st d out ) . Putc and putc har 
ar e m ac ro s . 

Fputc behaves like putc , but is a function rather than a 
macro. Fputc runs more slowly than putc , but takes less 
space per invocation. 

Putw writes the word (i.e., integer) w to the output stream 
at the position at which the file pointer, if defined, is 
pointing. The size of a word is the size of an integer and 
varies from machine to machine. Putw neither assumes nor 
causes special alignment in the file. 

Output streams, with the exception of the standard error 
stream st d er r , are by default buffered if the output refers 
to a file and line-buffered if the output refers to a termi- 
nal, The standard error output stream st d er r is by default 
unbuffered, but use of fr eopen ( see fo pen ( 3S ) ) causes it to 
become buffered or line-buffered. When an output stream is 
unbuffered information, it is queued for writing on the des- 
tination file or terminal as soon as written; when it is 
buffered, many characters are saved up and written as a 
block; when it is line-buffered, each line of output is 
queued for writing on the destination terminal as soon as 
the line is completed (i.e,, as soon as a new-line character 
is written or terminal input is requested), Setbuf (3S) may 
be used to change the stream’s buffering strategy. 
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SEE ALSO 

fclose(3S), ferror(3S), fopen(3S), frGad(3S), printf(3S), 
puts(3S), setbuf(3S). 

DIAGNOSTICS 

On success, these functions each return the value they have 
written. On failure, they return the constant EOF, This 
occurs if the file stream is not open for writing or if the 
output file cannot be grown. Because EOF is a valirf 
integer, f error ( 3S ) should be used to detect putw errors. 


BUGS 

Because it is implemented as a macro, putc treats 
incorrectly a st r earn argument with side effects. In partic- 
ular, putcCc, *f++); doesn’t work sensibly. Fput c should be 
used instead. 

Because of possible differences in word length and byte ord- 
ering, files written using putw are machine-dependent and 
may not be read using g e tw on a different processor. For 
this reason the use of putw should be avoided. 
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NAME 

putpwent - write password file entry 
SYNOPSIS 

#include <pwd .h> 

in t putpwent ( p , f ) 
struct passwd *p; 

FILE »f; 


DESCRIPTION 

Putpwent is the inverse of g e t pwen t ( 3 C ) . Given a pointer to 
a pa s s wd structure created by g e t pwen t (or g e t pwu i d or 
get pwn a m ) , put pwu i d writes a line on the stream f which 
matches the format of /etc/passwd. 


The <pwd,h> header file is described in getpwent (3C) . 

SEE ALSO 

get pwen t ( 3C ) . 


DIAGNOSTICS 

P u t p w e 1 i t returns non-zero if an error was detected during 
its operation; otherwise it returns zero. 


WARNING 

The above routine uses <stdio.h>. Therefore, the size of 
programs not otherwise using standard I/O is increased more 
than might be expected. 
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NAME 

puts, fputs - put a string on a stream 
SYNOPSIS 

#include <stdio.h> 

int puts (s) 
charts; 

int fputs (s, stream) 
char * s ; 

FILE ^stream; 


DESCRIPTION 

Put s writes the null-terminated string pointed to by s, fol- 
lowed by a new-line character, to the standard output stream 
s t d o u t . 

Fputs writes the n ul 1- 1 er m in a ted string pointed to by _s to 
the named output strea m . 

Neither function writes the terminating null character, 

SEE ALSO 

ferror(3S), fopen(3S), fread(3S), printf(3S), putc(3S). 


DIAGNOSTICS 

Both routines return EOF on error. This occurs if the rou- 
tines try to write on a file that has not been opened for 
writing. 


NOTES 

Puts appends a new-line character while fputs does not. 
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NAME 

qsort ^ quicker sort 
SYNOPSIS 

void qsort ((char *) base, nel , sizeof (*base), compar 
unsigned int nel ; 
in t ( * compar ) ( ) ; 

DESCRIPTION 

Qsort is an implementation of the quicker-sort algorithm. 
It sorts a table of data in place. 

points to the element at the base of the table. Nel is 
the number of elements in the table. Com par is the name of 
the comparison function, which is called with two arguments 
that point to the elements being compared. Depending on 
whether the first argument is to be considered less than, 
equal to, or greater than the second argument, the compar 
function must return an integer less than, equal to, or 
greater than zero. 

NOTES 

The pointer to the base of the table should be of type 
po in ter- to-el emen t and cast to type po inter- to-char ac ter . 

The comparison function need not compare every byte, so 
arbitrary data may be contained in the elements in addition 
to the values being compared. 

Although declared as type po i n t er- to- char ac t er , the value 
returned should be cast into type po i n t e r- to- el em en t . 

SEE ALSO „ 

sort(1), bsearch(3C), lsearch(3C), string(3C). 
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NAME 

rand, srand - simple random-number generator 

SYNOPSIS 

int rand ( ) 

void sr and (seed) 
un signed seed ; 

DESCPIPTION 

Rand uses a multiplicative congruential random-number gen- 
erator with period 283P9 that returns successive pseudo-random 
numbers in the range from 0 to 281 59''1. 

Sr and can be called at any time to reset the random-number 
generator to a random starting point. The generator is ini- 
tially seeded with a value of 1. 


NOTE 

The spectral properties of rand leave a great deal to be 
desired. Dr and 4 8 ( 3 C ) provides a much better, though more 
elaborate, random-number generator. 


SEE ALSO 

drand48 ( 30 . 
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NAME 

regcmp, regex - compile and execute a regular expression 
SYNOPSIS 

char *regcmp( str ing 1 [, stringP, ...], 0) 
char »string1, *string2, 

char *regex(re, subjectC, retO, 
char *re, ^subject, *retO, 

ex tern char * loc 1 ; 

DESCRIPTION 

Regcmp compiles a regular expression and returns a pointer 
to the compiled form, Mai loc ( 3C ) is used to create space 
for the vector. It is the user’s responsibility to free 
unneeded space that has been allocated by m al 1 oc . A NULL 
return from regcmp indicates an incorrect argument. 

R eg cm p ( 1 ) has been written to generally preclude the need 
for this routine at execution time. 

Regex executes a compiled pattern against the subject 
string. Additional arguments are passed to receive values 
back. Rege x returns NULL on failure or a pointer to the 
next unmatched character on success. A global character 
pointer loc 1 points to where the match began. Reg cm p and 
rege x were mostly borrowed from the editor, however, 

the syntax and semantics have been changed slightly. The 
following are the valid symbols and their associated mean- 
ings . 

[]*.'' These symbols retain their current meaning. 

$ This symbol matches the end of the string; \n 

matches the new- line, 

- V/ithin brackets the minus means "through”. For 

example, [a-z] is equivalent to [ ab cd . . . x yz ] . The 
«• can appear as itself only if used as the last or 
first character. For example, the character class 
expression []-:•] matches the characters ] and -. 

+ A regular expression followed by + means "one or 

more times". For example, [0-93+ is equivalent to 
[0-9][0^9]*. 

{m} {m,} Integer values enclosed in {} indicate the 

number of times the preceding regular expression 
is to be applied. The minimum number is m and the 
maximum number is u, which must be less than 256. 
If only m is present (e.g,, { ni} ) , it indicates the 

exact number of times the regular expression is to 
be applied, {£#) is analogous to { m , in f i n i ty} . 
The plus (+) and star (*) operations are 
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equivalent to {1,} and {0,}, respectively. 

( ... ) The value of the enclosed regular expression is to 

be returned. The value will be stored in the 
(n+J_)th argument following the subject argument. 
At present, at most 10 enclosed regular expres- 
sions are allowed. Peg ex makes its assignments 
unconditionally. 

( ... ) Parentheses are used for grouping. An operator 
(e.g., •, +, {}) can work on' a single character or 
a regular expression enclosed in parentheses. For 
example, ( a* ( cb+ ) • ) $0 . 

By necessity, all the above defined symbols are special. 
They must, therefore, be escaped to be used as themselves. 

EXAMPLES 

Example 1 : 

char ^cursor, *newcursor, *ptr; 

newcursor = regex((ptr = r eg cmp ( " \n" , 0)), cursor); 
f r ee ( pt r ) ; 

This example will match a leading new-line in the subject 
string pointed at by cursor. 

Example 2 : 

char ret0[9]; 

char *newcursor, *name; 

name = r eg cmp ( " ( [ A-Za-z ] [ A-za-z 0-9__] { 0 , 7 } ) $0 ” , 0); 

newcursor = regex(name, " 1 23Test ing32 1 " , retO); 

This example will match through the string ''Testing3*’ and 
will return the address of the character after the last 
matched character (cursor+11). The string ''Testing3'' will 
be copied to the character array r e 1 0 . 

Example 3 : 

//include "file.i" 

char *string, ^newcursor; 

newcursor = regexCname, string); 

This example applies a precompiled regular expression in 
file.i (see r eg cmp ( 1 ) ) against string . 

This routine is kept in / 1 ib/ 1 ib PW . a . 

SEE ALSO 

ed(l), regcmp(l), malloc(3C). 
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BUGS 

The user program may run out of memory if r eg cm p is called 
iteratively without freeing the vectors no longer required. 
The following user-supplied replacement for m al 1 oc ( 3 C ) 
reuses the same vector, saving time and space: 

/* user’s program */ 

m al 1 oc ( n ) { 

staticintrebuf[256]; 
return rebuf; 

} 
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NAME 

scanf, fscanf, sscanf - convert formatted input 

SYNOPSIS 

#include <stdio.h> 

int scanf (format [ , pointer ] ... ) 

char ^format; 

int fscanf (stream, format [ , pointer ] ) 

FILE •stream; 
char •format; 

int sscanf (s, format [ , pointer ] ) 

char •s, •format; 

DESCRIPTION 

Scanf reads from the standard input stream st d in . Fscanf 
reads from the named input stream . Ssc an f reads from the 
character string s. Each function reads characters, inter- 
prets them according to form at , and stores the results in 
its arguments. Each function expects two arguments: a con- 
trol string format (described below) and a set of pointer 
arguments indicating where the converted input should be 
stored . 

The control string usually contains conversion specifica- 
tions, which are used to direct interpretation of input 
sequences. The control string may contain: 

1. White-space characters (blanks and tabs) which, except in 
two cases described below, cause input to be read up to 
the next non- white-space character, 

2. An ordinary character (not %), which must match the next 
character of the input stream. 

3. Conversion specifications, consisting of the character %, 
an optional assignment suppression character •, an 
optional numerical maximum field width, an optional 1 or 
h indicating the size of the receiving variable, and a 
conversion code, 

A conversion specification directs the conversion of the 
next input field; the result is placed in the variable 
pointed to by the corresponding argument, unless assignment 
suppression has been indicated by •, The suppression of 
assignment provides a way of describing an input field which 
is to be skipped. An input field is defined as a string of 
non-white-space characters; it extends to the next inap- 
propriate character or until the field width, if specified, 
i s exhausted , 

The conversion code indicates the interpretation of the 
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input field; the corresponding pointer argument must usually 
be of a restricted type. For a suppressed field, no pointer 
argument should be given. The following conversion codes 
are legal: 

% A single % is expected in the input at this point; no 
assignment is done. 

d A decimal integer is expected; the corresponding argu- 
ment should be an integer pointer. 

U An unsigned decimal integer is expected; the 

corresponding argument should be an unsigned integer 
pointer , 

O An octal integer is expected; the corresponding argu- 

ment should be an integer pointer, 

X A hexadecimal integer is expected; the corresponding 
argument should be an integer pointer, 

e , f ,g 

A floating point number is expected; the next field is 
converted accordingly and stored through the 
corresponding argument, which should be a pointer to a 
float . The input format for floating point numbers is 
an optionally signed string of digits, possibly con- 
taining a decimal point, followed by an optional 
exponent field consisting of an E or an e, followed by 
an optionally signed integer, 

s A character string is expected; the corresponding argu- 
ment should be a character pointer to an array of char- 
acters large enough to accept the string and a ter- 
minating \0 , which will be added automatically. The 
input field is terminated by a white-space character, 
c A character is expected; the corresponding argument 
should be a character pointer. The normal skip over 
white space is suppressed in this case; to read the 
next non-space character, use %1s, Tf a field width is 
given, the corresponding argument should refer to a 
character array; the indicated number of characters is 
read , 

C String data and the normal skip over leading white 

space is suppressed. The left bracket is followed by a 
set of characters (the sc an se t ) and a right bracket; 
the input field is the maximal sequence of input char- 
acters consisting entirely of characters in the scan- 
set , The circumflex, (‘^), when it appears as the first 
character in the sc anse t , serves as a complement opera- 
tor and redefines the sc an se t as the set of all charac- 
ters not contained in the remainder of the scanse t 
string. There are somie conventions used in the con- 
struction of the sc an se t , A range of characters may be 
represented by the construct fi rst - last ; thus, 
[0123^567893 may he expressed [0-93. Using this con- 
vention, first must be lexically less than or equal to 
last, or else the dash will stand for itself. The dash 
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will also stand for itself whenever it is the first or 
the last character in the sc an se t , To include the 
right square bracket as an element of the scanset . it 
must appear as the f i r s t c har ac t er (possibly preceded 
by a circumflex) of the scanset ; otherwise it will be 
interpreted syntactically as the closing bracket. The 
corresponding argument must point to a character array 
large enough to hold the data field and the terminating 
\0 , which will be added automatically. 

The conversion characters d, u, o, and % may be preceded by 
1 or h to indicate that a pointer to long or short, rather 
than int, is in the argument list. Similarly, the conver- 
sion characters e, f, and g may be preceded by 1 to indicate 
that a pointer to double, rather than float, is in the argu- 
ment 1 i st , 

Sc an f conversion terminates at EOF, at the end of the con- 
trol string, or when an input character conflicts with the 
control string. In the latter case, the offending character 
is left unread in the input stream. 

Scan f returns the number of successfully matched and 
assigned input items; this number can be zero when an early 
conflictbetween an input character and the control string 
occurs. If the input ends before the first conflict or 
conversion, EOF is returned, 

EXAMPLES 

The call 

int i; float x; char name[50]; 
scanf ('’%d%fjs”, &i, &x, name); 

with the input line 

25 54.32E-1 thompson 

will assign the value 25 to and the value 5.432 to 
name will contain thompsonXO, 

The call 

int i; float x; char name[50]; 

scanf %[0-93”, &i, &x, name); 

with input 

56789 0123 56a72 

will assign 56 to _i, 789.0 to skip 0123, place the 

string 56\0 in name . The next call to g etc har (see 
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ge tc (3F)) will return a. 

SEE ALSO 

atof(3C), getc(3S), printf(3S), strtol(3C). 


NOTE 

Trailing white space is left unreal unless matched in the 
controlstring. 

DIAGNOSTICS 

These functions return EOF on end of input and a short count 
for missing or illegal data items. 


BUGS 

The success of literal matches and suppressed assignments is 
not directly determinable. 
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NAME 

setbuf - assign buffering to a stream 
SYNOPSIS 

#include <stdio.h> 

void setbuf (stream, buf) 

FILE ^stream; 
char • buf ; 

DESCRIPTION 

Setbuf is used after a stream has been opened but before it 
is read or written. It causes the character array pointed 
to by buf to be used instead of an automatically allocated 
buffer. If buf is a NULL character pointer, input/output 
will be completely unbuffered. 

A constant BUFSIZ, defined in the <stdio,h> header file, 
tells how big an array is needed; 

char_^f [BUFSIZ] ; 

A buffer is normally obtained from malloc (3C) at the time of 
the first ££^£(3S) or put c ( 3S ) on the file, except that the 
standard error stream st d er r is normally not buffered. 

Output streams directed to terminals are always line- 
buffered unless they are unbuffered. 

SEE ALSO 

fopen(3S), getc(3S), malloc(3C), putc(3S). 

NOTE 

A common source of error is allocating buffer space as an 
''automatic’’ variable in a code block and then failing to 
close the stream in the same block. 
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NAME 

setjmp, longjm p - non- local goto 

SYNOPSIS 

#include <setjnip.h> 

int setjmp (env) 
jmp__buf env; 

void longjmp (env, val) 
jmp^buf env; 
int val; 

DESCRIPTION 

These functions are useful for dealing with errors and 
interrupts encountered in a low-level subroutine of a pro- 
gram. 

Setjmp saves its stack environment in en v for later use by 
longjmp . The environment type jmp buf is defined in the 
<setjmp.h> header file. Se t jm p returns the value 0. 

Longjmp restores the environment saved by the last call of 
setjmp with the corresponding env argument. After longjmp 
is completed, program execution continues as if the 
corresponding call of setjmp (which must not itself have 
returned in the interim) had just returned the value val . 
Longjmp cannot cause setjmp to return the value 0. If 
longjmp is invoked with a second argument of 0, setjmp will 
return 1. All accessible data have values as of the time 
1 ong j m p wascalled. 

SEE ALSO 

si gnal ( 2 ) . 

WARNING 

Longjmp fails if it is called when env was never primed by a 
call to setjmp or when the last such call is in a function 
which has since returned. 
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NAME 

sinh, cosh, tanh - hyperbolic functions 


SYNOPSIS 

linclude <rnath.h> 


double sinh (x) 
double X ; 

double cosh (x) 
double x; 


double tanh (x) 
double x; 


DESCRIPTION 

Sinhf and tan h return, respectively, the hyberbolic 

sine, cosine, and tangent of their argument. 


DIAGNOSTICS 

Sinh and cosh return HUGE when the correct value would over-- 
flow and set err no to EPANGE. 

These error-handling procedures may be changed with the 
function matherr ( 3M) . 


SEE ALSO 

niatherr(3M) . 
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NAME 

sleep - suspend execution for interval 
SYNOPSIS 

unsigned sleep (seconds) 
unsigned seconds; 

DESCRIPTION 

Sleep suspends the current process from execution for the 
number of sec ond s specified by the argument. The actual 
suspension time may be less than that requested for two rea- 
sons: (1) scheduled wakeups occur at fixed 1-second inter- 

vals, (on the second, according to an internal clock) and 
(2) any caught signal will terminate sleep following execu- 
tion of the signal catching routine. The suspension time 
m. ay be longer than requested by an arbitrary amount, due to 
the scheduling of other activity in the system. The value 
returned by slee p is the ''unslept’’ amount ( the r e que sted 
time minus the time actually slept) in case the caller had 
an alarm set to go off earlier than the end of the requested 
sleep time or in case there is premature arousal due a to 
another caught signal. 

The routine is implemented by setting an alarm signal and 
pausing until it (or some other signal) occurs. The previ- 
ous state of the alarm signal is saved and restored. The 
calling program may have set up an alarm signal before cal- 
ling si eep . If the sleep time exceeds the time before the 
alarm signal, the process sleeps only until the alarm signal 
would have occurred and the caller’s alarm catch routine is 
executed just before the sleep routine returns. If the 
slee p time is less than the time before the calling 
program’s alarm, the prior alarm time is reset to go off at 
the same time it would have without the intervening sleep . 

SEE ALSO 

alarm(2), pause(2), signal(2). 
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NAME 

sputl, sgetl - access long integer data in a machine 
independent fashion. 

SYNOPSIS 

void sputl (value, buffer) 
long value; 
char *buf fer ; 

long sgetl (buffer) 
char ^buffer; 

DESCRIPTION 

Sputl takes the 4 bytes of the long integer value and places 
them in memory, starting at the address pointed to by 
bu ffer . The ordering of the bytes is the same across all 
machines. 

Sgetl retrieves the 4 bytes in memory, starting at the 
address pointed to by buffer , and returns the long integer 
value in the byte ordering of the host machine. 

Use of sputl and sgetl in combination provides a machine 
independent way of storing long numeric data in a file in 
binary form without conversion to characters, 

A program that uses these functions must be loaded with the 
object file access routine library libld.a. 

SEE ALSO 

ar ( 4 ) . 
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NAME 

ssignal, gsignal - software signals 

SYNOPSIS 

linclude <signal.h> 

int (*ssignal (sig, action))( ) 
int sig, (*action)( ); 

int gsignal (sig) 
int sig; 

DESCRIPTION 

Ssignal and gsignal implement a software facility similar to 
si gnal ( P ) . This facility is used by the Standard C Library 
to enable users to indicate the disposition of error condi- 
tions; it is also made available to users for their own pur- 
poses. 

Software signals made available to users are associated with 
integers in the inclusive range 1 through 15. A call to 
ssignal associates a procedure, ac tion , with the software 
signal, sig ; the software signal, sig , is raised by a call 
gsignal . Raising a software signal causes the action 
established for that signal to be taken. 

The first argument to ssignal is a number identifying the 
type of signal for which an action is to be established. The 
second argument defines the action; it is either the name of 
a user-defined action function or one of the manifest con- 
stants SIG__DFL (default) or SIG_^IGN (ignore), Ssigna l 
returns the action previously established for that signal 
type; if no action has been established or the signal number 
( sig ) is illegal, ssignal returns SIG__DFL. 

Gsi gnal raises the signal identified by its argument, sig : 

If an action function has been established for sig , 
then that action is reset to SIG^DFL and the action 
function is entered with argument sig . Gsignal returns 
the value returned to it by the action function. 

If the action for sig is SIG^^IGN, g signal returns the 
value 1 and takes no other action. 

If the action for sig is SIG__DFL, gsignal returns the 
value 0 and takes no other action. 

I f sig has an illegal value or no action was ever 
specified for sig , gsignal returns the value 0 and 
takes no other action. 

NOTES 

There are some additional signals with numbers outside the 

* 
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range 1 through 15 which are userf by the Standard C Library 
to ind ic ate error conditions. Thus, some signal numbers 
outside the range 1 through 15 are legal, although their use 
may interfere with the operation of the Standard C Library. 
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NAME 

stdio - standard buffered input/output package 

SYNOPSIS 

linclude <stdio,h> 

FILE *stdin, •stdout, *stderr; 

DESCRIPTION 

The functions described in the en tries of sub --class 3S of 
this manual constitute an efficient, user-level I/O buffer- 
ing scheme. The input/output function may be grouped into 
the following categories: file access, file status, input, 
output, miscellaneous. For lists of the functions in each 
category, refer to the "Libraries" section of the Program- 
ming Guid e. The in-line macros g e tc ( 3S ) and put c ( 3S ) handle 
characters quickly. The macros g e t c h a r and p u t c h a r , and the 
higher-level routines fget c , f ge t s , f pr in t f , f put c , f put s , 
f r ea d , f sc an f , f wr i t e , ge t s , ge tw , pr in t f , puts , pu t w , and 
sc an f all use g e tc and p u t c ; they can be freely intermixed. 

A file with associated buffering is called a stream and is 
declared to be a pointer to a defined type FILE. Fopen ( 3S ) 
creates certain descriptive data for a stream and returns a 
pointer to designate the stream in all further transactions. 
Normally, there are three open streams with constant 
pointers declared in the <stdio,h> header file and associ- 
ated with the standard open files: 

stdin standard input file 

stdout standard output file 

stderr standard error file. 

A constant NULL (0) designates a nonexistent pointer. 

An integer constant EOF (-1) is returned upon end-of-file or 
error by most integer functions that deal with streams (see 
the individual descriptions for details). 

Any program that uses this package must include the header 
file of pertinent macro definitions, as follows: 

#include <stdio.h> 

The functions and constants mentioned in the entries of 
sub-class 3S of this manual are declared in that header file 
and need no further declaration. The constants and the fol- 
lowing functions are implemented as macros: geto , getchar , 
put c , put char , f eo f , Terror , c l ear err , and f i leno . Rede- 
claration of these names is perilous. 

The <stdio,h> file is illustrated in the "Libraries" section 
of the Pr og r amm ing Guide, 
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SEE ALSO 

open(2), close(2), lseGk(2), pipe(2), read(2), write(2), 
ctermid(3S), cuserid(3S), fclose(3S), ferror(3S), fopen(3S), 
fread(3S), fseek(3S), getc(3S), gets(3S), popen(3S), 
printf(3S), putc(3S), puts(3S), scanf(3S), setbuf(3S), 
syst err. ( 3S ) , tmpfilG(3S), tmpnam(3S)» ungetc(3S). 

DIAGNOSTICS 

Invalid st r e a m pointers cause serious errors, possibly 
including program termination. Individual function descrip- 
tions describe the possible error conditions. 
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NAME 

stdipc - standard interprocess communication package 
SYNOPSIS 

#include < sys/ t ype s .h> 
i/include <sys/ipc.h> 

key__t ftok(path, id) 
char*path; 
c h a r i d ; 

DESCRIPTION 

All interprocess communication facilities require the user 
to supply a key to be used by the m sgg e t ( 2 ) « semget ( 2 ) , and 
shm g e t ( 2 ) system calls to obtain interprocess communication 
identifiers. One method for forming a key is to use the 
f tok subroutine described below. Another way to com pose 
keys is to include the project ID in the most significant 
byte and to use the remaining portion as a sequence number. 
There are many other ways to form keys, but it is necessary 
for each system to define standards for forming them. If a 
standard is not adhered to, unrelated processes may inter- 
fere with each other’s operation. Therefore, it is strongly 
suggested that the most significant byte of a key in some 
sense refer to a project so that keys do not conflict across 
a given system . 

Ftp k returns a key based on path and that is usable in 
subsequent msgget , semget , and shm get system calls. Path 
must be the pathname of an existing file that is accessible 
to the process. Id is a character that uniquely identifies 
a project. Ft o k returns the same key for linked files when 
called with the same ; it returns different keys when 
called with the same filename but different ids. 

SEE ALSO 

intro(2), msgget(2), semget(2), shmget(2). 

DIAGNOSTICS 

Ft o k returns (key__t) --I if path does not exist or if it is 
not accessible to the process. 

WARNING 

If the file whose path is passed to f to k is removed when 
keys still refer to the file, future calls to f tok with the 
same path and ^ will return an error. If the same file is 
recreated, f to k is likely to return a different key than it 
did the original time it was called. 
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NAME 

stime - set time 

SYNOPSIS 

int stime (tp) 
long *tp; 

DESCRIPTION 

Stime sets the system's idea of the time and date, Tp 
points to the value of time as measured in seconds from 
00:00:00 GMT January 1, 1970. 

Stime fails if the effective user ID of the calling process 
is not superuser, [EPERM] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Oth- 
erwise, a value of -1 is returned and err no is set to indi- 
cate the error. 

SEE ALSO 

time( 2 ) . 
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NAME 

strcat, strncat, strcrnp, strncmp, strcpy, strncpy, strlen, 
strchr, strrchr, strpbrk, strspn, strcspn, strtok string 
oper at ions 

SYNOPSIS 

linclude <string.h> 

char *strcat (si, s2) 
char * s 1 , • s2 ; 

char *strncat (si, s2, n) 

char*s1,*s2; 

in t n ; 

in t strcrnp (si, s2) 
char *s1, *s2; 

int strncmp (si, s2, n) 
char *31, * s2 ; 
int n ; 

char*strcpy(s1,s2) 
char *s1, *s2; 

char •strncpy (si, s2, n) 
char • s 1 , • s2 ; 
int n ; 

int strlen (s) 
char • s ; 

char*strchr(s,c) 
charts, c ; 

char *strrchr (s, c) 
char * s , c ; 

char •strpbrk (si, s2) 
char •si, ^32; 

in t str spn (si, s 2) 
char •si, ^32; 

int strcspn (si, s2) 
char •si, ^32; 

char •strtok (si, s2) 
char •si, ^32; 

DESCRIPTION 

The arguments , and £ point to strings (arrays of 

characters terminated by a null character). The functions 
strcat , strncat, s trc py , and strncpy all alter ££. These 
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functions (io not check for overflow of the array pointed to 
by . 

St r c a t appends a copy of string _s£ to the end of string s 1 . 
S t r n c a t appends atmost n characters. Each function returns 
a pointer to the n u 1 1 ^ t er m in a t ed result. 

Str cm p performs a lexicographical comparison of its argu- 
ments and returns an integer less than, equal to, or greater 
than 0, when is less than, equal to, or greater than s? , 
respectively. Str ncmp makes the same comparison but looks 
at a maximum of ri characters. 

Str c py copies string _s? to string £2, stopping after the 
null character has been copied. St r nc py copies exactly n 
characters, truncating ^ or adding null characters to ^ if 
necessary. The result is not null-terminated if the length 
of _s_? is n or more. Each function returns s 1 . 

St r 1 e n returns the number of characters in not including 
the terminating null character. 

St r c hr ( st r r c hr ) returns a pointer to the first (last) 
occurrence of character £ in string _s , or a NULL pointer if 
£ does not occur in the string. The null character ter- 
minating a string is considered to be part of the string. 

Str pbr k returns a pointer to the first occurrence in string 
si of any character from string ££ , or a NULL pointer if no 
"cTiaracter from s_2 exists in s 1 . 

St r spn ( str c sp n) returns the length of the initial segment 
of string _sj_ which consists entirely of characters from (not 
from) string s2 . 

Str to k considers the string sj_ to consist of a sequence of 
zero or more text tokens separated by spans of one or more 
characters from the separator string _s2. The first call 
(with pointer £_1 specified) returns a pointer to the first 
character of the first token, and writes a null character 
into s£ immediately following the returned token. The func- 
tion keeps track of its position in the string between 
separate calls, so that on subsequent calls (which must be 
made with a NULL pointer as the first argument) it works 
through the string £j_ immediately following that token. 
This can be continued until no tokens remain. The separator 
string _s_2 may be different from call to call. When no token 
remains in £jl, a NULL pointer is returned. 

NOTE 

For user convenience, all these functions are declared in 
the optional <string,h> header file. 
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BUGS 

_^rcirip anH s t r ncm p use native character comparison, which is 
signed on PDP-lls, unsigned on other machines. 

Character movement is performed differently in different 
implementations; therefore, overlapping moves may yield 
unexpected results. 
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NAME 

strtol, atol, atoi - convert string to integer 
SYNOPSIS 

long strtol (str, ptr, base) 
char *str; 
char ** ptr ; 
in t b ase ; 

long atol (str) 
char*str; 

int atoi ( str) 
char * s t r ; 

DESCRIPTION 

Strtol returns as a long integer the value represented by 
the character string str . The string is scanned up to the 
first character inconsistent with the base. Leading white- 
space characters (blanks and tabs) are ignored. 

If the value of ptr is not (char **)NULL, a pointer to the 
character terminating the scan is returned in * pt r . If no 
integer can be formed, zero is returned. 

If base is positive (and not greater than 36), it is used as 
the base for conversion. After an optional leading sign, 
leading zeros are ignored; a leading Ox or OX is ignored if 
is 16. 

If base is zero, the string itself determines the base. 
After an optional leading sign, a leading zero indicates 
octal conversion and a leading Ox or OX indicates hexade- 
cimal conversion; otherwise, decimal conversion is used. 

Truncation from long to int can take place upon assignment 
or by an explicit cast. 

Atol ( str ) is equivalent to str tol ( str , (char **)NULL, 10). 

Ato i ( st r ) is equivalent to ( int ) str tol ( str , (char **)NULL, 

10 ). 

SEE ALSO 

atof(3C), scanf(3S). 


BUGS 

Overflow conditions are ignored. 
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NAME 

swab - swap bytes 
SYNOPSIS 

void swab (from, to, nbytes) 
char * from , * to ; 
int nbyte s ; 

DESCRIPTION 

Swab copies nbytes bytes pointed to by from to the array 
pointed to by exchanging adjacent even and odd bytes. 

It is useful for carrying binary data between PDP-lls and 
other machines. Nbytes should be even and non-negative. If 
nbytes is odd and positive, swab uses nbytes - 1 instead. If 
nbyt es is negative, swab does nothing. 
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NAME 

sync - upiiate super-block 

SYNOPSIS 

void sync ( ) 


DESCRIPTION 

Syn c causes all information in memory that should be on disk 
to be written out. This includes modified super-blocks, 
modified inodes, and delayed block I/O. 

It should be used by programs which examine a file system, 
for example f s c k ( 1 M ) and £_f(1M), It is mandatory before a 
boot . 


The writing, although scheduled, is not necessarily complete 
upon return from sync . 

SEE ALSO 

Administrator's Manual. 
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NAME 

system - issue a shell command 

SYNOPSIS 

finclude <stdio.h> 

int system (string) 
char * st r ing ; 


DESCRIPTION 

System causes s tring to be given to _sh(1) as input, as if 
the string had been typed as a command at a terminal. The 
current process waits until the shell has completed, then 
returns the exit status of the shell. 


FILES 

/ bin/ sh 


SEE ALSO 

sh(1), exec(2). 


DIAGNOSTICS 

Syste m forks to create a child process that in turn performs 
ex ec ( 2 ) on / b i n / s h in order to execute string . If the fork 
or exec fails, system returns -^1 and sets er r no . 
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NAME 

tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs - terminal 
Independent operation routines 

SYNOPSIS 

char PC ; 
char *80; 
char *UP; 
short ospeed ; 

tgetentCbp, name) 
char * bp , *narae ; 

tgetnum ( id ) 
char * i d ; 

tgetflag ( id ) 
char * i d ; 

char * 

tgetstr ( id , ar ea ) 
char * id , » ar e a ; 

char * 

tgotoCcm, destcol, destline) 
char *om; 

tputsCcp, affcnt, outc) 
register char *cp; 
int affcnt; 
int »outc)(); 

DESCRIPTION 

These functions extract and use capabilities from the termi- 
nal capability data base ter me ap (5). Note that these are 
low-level routines. 

Tge ten t extracts the entry for terminal name into the buffer 
at ^ should be a character buffer of size 1024 and 

must be retained through all subsequent calls to tgetnum , 
tget f 1 ag , and tgetstr . Tgeten t returns -1 if it cannot open 
the termcap file, 0 if the terminal name given does not have 
an entry, and 1 if successful. It looks in the environment 
for a TERMCAP variable. If a variable is found whose value 
does not begin with a slash and the terminal type name is 
the same as the environment string TERM, the TERMCAP string 
is used instead of reading the termcap file. If the value 
does begin with a slash, the string is used as a pathname 
rather than /etc/termcap . This can speed up entry into pro- 
grams that call tgetent . It can also help debug new termi- 
nal descriptions or be used to make one for your terminal if 
you can’t write the file /etc/termcap. 
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Tg e tn um gets the numeric value of capability , returning 

1 if is not given for the terminal. Tg e t f 1 ag returns 1 if 
the specified capability is present in the terminal’s entry, 
0 if it is not. Tgetstr gets the string value of capability 
id , placing it in the buffer at area , advancing the a rea 
pointer. Tt decodes the abbreviations for this field 
described in termc ap ( 5 ) , except for cursor addressing and 
padding information. 

Tgoto returns a cursor addressing string decoded from _cm to 
go to column d est col in line d estl ine . It uses the external 
variables UP (from the up capability) and BC (if be is given 
rather than bs) if necessary to avoid placing \n, ''D or ''g 
in the returned string. (Programs that call tgoto should be 
sure to turn off the XTABS bit(s), since tgoto may now out- 
put a tab. Note that programs using termc ap should in gen- 
eral turn off XTABS anyway since some terminals use 
control-I for other functions, such as nondestructive 
space.) If a % sequence is given which is not understood, 
then tgoto returns OOPS. 

Tput s decodes the leading padding information of the string 
c p ; a f f cn t gives the number of lines affected by the opera- 
tion, or 1 if this is not applicable; out c is a routine that 
is called with each character in turn. The external vari- 
a b 1 e ospee d should contain the output speed of the terminal 
as encoded by s 1 1 y (£). The external variable PC should con- 
tain a pad character to be used (from the pc capability) if 
a null (''§) is inappropriate. 


FILES 

/ usr / 1 i b / 1 ib ter m c ap . a -Itermcap library 
/etc/termcap data base 


SEE ALSO 

ex ( 1 ) , termcap( 5 ) 
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NAME 

time - get time 

SYNOPSIS 

long time ((long *) 0) 

long time (tloc) 
long *tloc; 

DESCRIPTION 

Time returns the value of time in seconds since 00:00:00 
GMT, January 1, 1970. 

If tloc (taken as an integer) is non-zero, the return value 
is also stored in the location to which tloc points. 

Time fails if tloc points to an illegal address. [EFAULT] 

RETURN VALUE 

Upon successful completion, time returns the value of time. 
Otherwise, a value of -1 is returned and err no is set to 
indicate the error. 


SEE ALSO 

st i m e ( 2 ) . 
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NAME 

tmpfile - create a temporary file 
SYNOPSIS 

#include <stdio.h> 

FILE »tmpfile () 

DESCRIPTION 

Tmpf ile creates a temporary file and returns a corresponding 
FILE pointer. The file is automatically deleted when the 
process using it terminates. The file is opened for update, 

SEE ALSO 

create?), unlinkC?), fopen(3S), mktemp(3C), trapnam(3S). 


- 1 


Printed 6 1985 



TMPIIAM(3S) 


TMPNAMCSS) 


NAME 

tmpnam, tempnam - create a name for a temporary file 
SYNOPSIS 

linclude <stdio.h> 

char • tm pn am ( s ) 
char *s; 

char *tempnara (dir, pfx) 
char*dir,*pfx; 

DESCRIPTION 

These functions generate filenames that can safely be used 
for a temporary file. 

Tm pn am always generates a filename using the pathname 
defined as P tmpdir in the <stdio.h> header file. If £ is 
NULL, tmpn am Teaves its result in an internal static area 
and returns a pointer to that area. The next call to tm pn am 
will destroy the contents of the area. If ^ is not NULL, it 
is assumed to be the address of an array of at least 
L tmpnam bytes, where L tmpnam is a constant defined in 
<stdio .h> ; t m pn am places its result in that array and 
returns _s . 

Tempnam allows the user to control the choice of a direc- 
tory. The argument dir points to the pathname of the direc- 
tory in which the file is to be created. If dir is NULL or 
points to a string which is not a pathname for an appropri- 
ate directory, the pathname defined as P tmpdir in the 
<stdio.h> header file is used. If that pathname is not 
accessible, /tmp will be used as a last resort. This entire 
sequence can be upstaged by providing an environment vari- 
able TMPDIR in the user’s environment, whose value is a 
pathname for the desired temporary-file directory. 

Many applications prefer that names of temporary files con- 
tain favorite initial letter sequences. Use the pfx argu- 
ment for this. This argument may be NULL or point to a 
string of up to 5 characters to be used as the first few 
characters of the name of the temporary file. 

Tempn am uses malloc C 3C) to get space for the constructed 
filename and returns a pointer to this area. Thus, any 
pointer value returned from tempn am may serve as an argument 
(see roalloc (3C)) . If tempn am cannot return the 
expected result for any reason (i.e., malloc failed or 
attempts to find an appropriate directory were unsuccess- 
ful), a NULL pointer will be returned. 


NOTES 

These functions generate a different filename each time they 
are called. 
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Files Great e«^ using these functions anH either f open ( 2 ) or 
crea_t(2) are temporary only in the sense that they reside in 
a directory intended for temporary use and their names are 
unique. It is the user’s responsibility to use uni ink ( 2 ) to 
remove the file when its use is ended. 

SEE ALSO 

creat(2), unlink(2), fopen(3S), raalloc(3C), mktemp(3C), 
tmpf i 1 e( 3S ) . 


BUGS 

If called more than 17,576 times in a single process, tmpn am 
and tempn a m will start recycling previously used names. 
Between the time a filename is created and the file is 
opened, it is possible for some other process to create a 
file with the same name. This can never happen if that 
other process is using tmpnam , tempn am , or mktemp C 30 and 
the filenames are chosen carefully to avoid duplication by 
other means. 
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NAME 

sin, cos, tan, asin, acos, atan, atan2 - trigonometric func- 
tions 

SYNOPSIS 

#include<math.h> 

double sin (x) 
double x; 

double cos (x) 
double X ; 

double tan ( x ) 
double X ; 

double asin ( x ) 
double X ; 

double acos (x) 
double X ; 

double atan ( x ) 
double x ; 

double atan2 (y, x) 
double X , y ; 

DESCRIPTION 

Sin , cos , and _^n return, respectively, the sine, cosine, 
and tangent of their argument, which is in radians. 

Asin returns the arcsine of 3^, in the range -J/2 to J/2. 

Acos returns the arccosine of £ , in the range 0 to J. 

Atan returns the arctangent of 3C , in the range -J/2 to J/2. 

At an2 returns the arctangent of y/jc, in the range -J to J, 
using the signs of both arguments to determine the quadrant 
of the return value. 

DIAGNOSTICS 

Sin, cos , and tan lose accuracy when their argument is far 
from zero. For arguments sufficiently large, these func- 
tions return 0 when there would otherwise be a complete loss 
of significance. In this case a message indicating TLOSS 
error is printed on the standard error output. For less 
extreme arguments, a PLOSS error is generated but no message 
is printed. In both cases, err no is set to ERANGE. 

Tan returns HUGE for an argument which is near an odd multi- 
ple of J/2 when the correct value would overflow; it sets 
err no to ERANGE. 
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Arguments of magnitu<^e greater than 1,0 cause a si n and ac o s 
to return 0 and to set er r no to EDOM. In addition, a mes- 
sage indicating DOMAIN error is printed on the standard 
error out put . 

These error-handling procedures may be changed with the 
function matherr (3M) . 

SEE ALSO 

matherr(3M) . 
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NAME 

tsearch, t^lelete, twalk - manage binary search trees 
SYNOPSIS 


linclude <search.h> 




char •tsearch ((char 
In t ( •compar ) ( ) ; 

• ) key. 

(char •») 

roo tp , compar ) 

char •tdelete ((char 

in t ( •compar ) ( ) ; 

•) key, 

(char ••) 

rootp, compar) 

void twalk ((char •) 
void ( •ac tion) ( ) ; 

root , ac 

tion) 



DESCRIPTION 

Tsearch is a binary tree search routine generalized from 
Knuth (6.2.P) Algorithm T. It returns a pointer into a tree 
indicating where data may be found. If the data does not 
occur, it is added at an appropriate point in the tree, Ke y 
points to the data to be sought in the tree, Roo t p points 
to a variable that points to the root of the tree. A NULL 
pointer value for the variable denotes an empty tree; in 
this case, the variable is set to point to the data at the 
root of the new tree. Compar is the name of the comparison 
function. It is called with two arguments that point to the 
elements being compared. If the first argument is to be 
considered less than, equal to, or greater than the second 
argument, the function must return an integer less than, 
equal to, or greater than zero, respectively. 

Td el e te deletes a node from a binary search tree. It is 
generalized from Knuth (6.2.2) algorithm D. The arguments 
are the same as for tsear£2i. The variable pointed to by 
roo t p will be changed if the deleted node was the root of 
the tree. Td el e te returns a pointer to the parent of the 
deleted node or a NULL pointer if the node is not found. 

Twal k traverses a binary search tree. Roo t is the root of 
the tree to be traversed. Any node in a tree may be used as 
the root for a walk below that node. Action is the name of 
a routine to be invoked at each node. This routine is, in 
turn, called with three arguments. The first argument is 
the address of the node being visited. The second argument 
is a value from an enumeration data type typed ef enum { 
pr eo rd er , postord er , end ord er , l_e^ } VISIT ; As defined in 
the <search,h> header file, the value of this data type 
depends on whether this is the first, second, or third time 
that the node has been visited (during a depth-r-first , left- 
to-right traversal of the tree), or whether the node is a 
leaf. The third argument is the level of the node in the 
tree; the root is level zero. 
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NOTES 

The pointers to the key and the root of the tree should be 
of type po i n te r- to- el em en t and cast to type pointer-to- 
character . 

The comparison function need not compare every byte; there- 
fore, arbitrary data may be contained in the elements in 
addition to the values being compared. 

Although declared as type po in ter-to-char ac ter , the value 
returned should be cast into type po in ter- to-el emen t . on 
entry. 

SEE ALSO 

bsearch(3C), hsearch(3C), lsearch(3C). 

BUGS 

Tse ar c h fails if the calling function alters the pointer to 
the root. 

WARNING 

The root argument to twa 1 k is one level of indirection less 
than the r oo t p arguments to t se ar c h and td el e te . 

DIAGNOSTICS 

A NULL pointer is returned by t search if there is not enough 
space available to create a new node. 

A NULL pointer is returned by tsearch and tdelete if rootp 
is NULL 
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NAME 

tty name, isatty - find name of a terminal 
SYNOPSIS 

char *ttyname (fildes) 
in t f i Id es ; 

in t isatty ( f i Id es) 
in t fildes; 

DESCRIPTION 

T t yn am e returns a pointer to a string containing the null- 
terminated pathname of the terminal device associated with 
file descriptor fildes . 

Isatty returns 1 if fildes is associated with a terminal 
device; otherwise, it returns 0. 


FILES 

/dev/* 


DIAGNOSTICS 

Tt yn am e returns a NULL pointer if f i Id e s does not describe a 
terminal device in directory /dev. 


BUGS 

The return value points to static data whose content is 
overwritten by each call. 
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NAME 

ttyslot find the slot in the utmp file of the current user 

SYNOPSIS 

int ttyslot ( ) 

DESCRIPTION 

Ttyslot returns the index of the current user’s entry in the 
/etc/utmp file. This is accomplished by scanning the file 
/etc/inittab for the name of the terminal device associated 
with the standard input, the standard output, or the error 
out put ( 0 , 1 , or 2 ) . 


FILES 

/ etc/ ini ttab 
/etc/utmp 


SEE ALSO 

getut(3G), ttyname(3C). 


DIAGNOSTICS 

A value of 0 is returned if an error is encountered while 
searching for the terminal name or if none of the above file 
descriptors is associated with a terminal device. 
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NAME 

ulimit - get and set user limits 
SYNOPSIS 

long ulimit (cmd, newlimit) 

in t cmd; 

long newl imi t ; 

DESCRIPTION 

This function provides for control over process limits. The 
cmd values available are: 

1 Get the process’s file size limit. The limit is in 
units of 512-byte blocks and is inherited by child 
processes. Files of any size can be re 
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NAME 

ungetc - push character back into input stream 
SYNOPSIS 

iinclude <stdio.h> 

int ungetc (c, stream) 
char c ; 

FILE ^stream; 

DESCRIPTION 

Unge tc inserts the character £ into the buffer associated 
with an input stream . That character, £, will be returned 
by the next g e tc call on that stream . Ungetc returns c and 
leaves the file stream unchanged. 

One character of pushback is guaranteed provided something 
has been read from the stream and the stream is actually 
buffered . 

If £ equals EOF, ungetc does nothing to the buffer and 
returns EOF. 

Fseek ( 3^ ) erases all memory of inserted characters. 

SEE ALSO 

fseek(3S), getc(3S), setbuf(3S). 

DIAGNOSTICS 

For ungetc to perform correctly, a read statement must have 
been performed prior to the call of the ungetc function. 
Ung etc returns EOF if it can’t insert the character. If 
strea m is s t d i n , un getc allows exactly one character to be 
pushed back onto the buffer without a previous read state- 
ment. 
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NAME 

intro - introduction to file formats 
DESCRIPTION 

This section outlines the header files and file formats used 
by C struct declarations for the file formats are given 
where applicable. Usually, these structures can be found in 
the directories /usr/include or / usr / incl ud e/ sys . 
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NAME 

a. out - common assembler and link editor output 

DESCRIPTION 

A. out is the output file from the assembler the 

link editor A . o ut can be executed on the target 

machine if there were no errors in assembling or linking and 
no unresolved external references. 


The object file format supports user-defined sections and 
contains extensive information for symbolic software test- 
ing. A common object file consists of a file header, an 
optional aout header, a table of section headers, relocation 
information, (optional) line numbers, and a symbol table. 
The order 


is given 

below. 

File header. 

Optional 

aout he ad er . 

Section 

1 header. 

Section 

n header. 

Section 

1 data. 

Section 

n data. 

Sec t ion 

1 relocation. 

Section 

n relocation. 

Section 

1 line number s . 

Sec t ion 

n line number s . 

Symbol table. 

Str ing table. 


The last four sections (relocation, line numbers, symbol 
table, and string table) may be missing if the program was 
linked with the -s option of Ijj. ( 1 ) or if the symbol table 
and relocation bits were removed by strip (l). Also note 
that if the program was linked without the -r option, the 
relocation information will be absent. The string table 
exists only if necessary. 

When an a. out file is loaded into memory for execution, 
three logical segments are set up; the text segment, the 
data segment (initialized data followed by uninitialized 
data, the latter actually being initialized to all O’s), and 
a stack. The text segment begins at location 0 in the core 
image; the header is not loaded. If the magic number (the 
first field in the optional aout header) is 407 (octal), it 
indicates that the text segment is not to be write-protected 
or shared, so the data segment will be contiguous with the 
text segment. If the magic number is 410 (octal), the data 
segment begins at the next segment boundary following the 
text segment, and the text segment is not writable by the 
program. If other processes are executing the same a. out 
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file, they will share a single text segment. 

On the 3B?0S, the stack begins at the enrf of the text and 
data sections and grows towards higher addresses. On the 
M 68000 family of processors and the VAX, the stack begins at 
the end of memory and grows toward lower addresses. The 
stack is automatically extended as required. The data seg- 
ment is extended only as requested by the br k ( 2 ) and sbr k ( 2 ) 
system calls. 

The value of a word in the text or data portions that is not 
a reference to an undefined external symbol is exactly the 
value that will appear in memory when the file is executed. 
If a word in the text involves a reference to an undefined 
external symbol, the storage class of the symbol-table entry 
for that word will be marked as an ''external symbol’’, and 
the section number will be set to 0. When the file is pro- 
cessed by the link editor and the external symbol becomes 
defined, the value of the symbol will be added to the word 
in the file. 

See ao ut hd r ( 4 ) , f i 1 ehd r ( 4 ) , 1 inenum ( 4 ) , scnhdr ( 4 ) , r el oc ( 4 ) , 
and sym s ( 4 ) for descriptions of the individuals parts. 
Every section created by _as( 1 ) contains a mul t i pi e-of- fo ur 
number of bytes; directives to !;£( 1 ) can create a section 
with an odd number of bytes, 

SEE ALSO 

as(1), cc(1), ld(i), aouthdr(4), filehdr(4), ldfcn(4), line- 
num(4), reloc(4), scnhdr(4), syms(4). 
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NAME 

acct - per-process accounting file format 
SYNOPSIS 

linclude <sys/acct.h> 

DESCRIPTION 

Files produced as a result of calling ac c t ( 2 ) have records 
in the form defined by < sys/ ac c t , h> , whose contents are; 


t yped e f 

ushort comp t ; 

/« H 

floating point" */ 


/* 1 3 

-bit fraction. 

3-bit exponent •/ 

struct 

{ 

acct 




char 

ac__ f 1 ag ; 

/* 

Accounting flag */ 


char 

ac st a t ; 

/* 

Exit status */ 


ushort 

ac ui d ; 




ushort 

ac_gid ; 




dev t 

ac tty; 




time t 

ac_bt ime ; 

/* 

Beginning time */ 


comp t 

ac utime; 

/» 

acctng user time in clock ticks */ 


comp t 

ac__st ime ; 

/* 

acctng system time in clock ticks 


comp__t 

ac e t i m e ; 

/* 

acctng elapsed time in clock ticks 


comp t 

ac mem; 

/* 

memory usage in clicks */ 


comp t 

ac io ; 

/* 

chars trnsfrd by read/write */ 


comp t 

ac_r w ; 

/* 

number of block reads/writes */ 

} ; 

char 

ac comm [83 

; /* 

command name »/ 

extern 

struct 

acct 

acc tbuf ; 

extern 

struct 

i nod e 

*acctp; /* inode of accounting file 

y/ d e f i n e 

AFOPK 

01 

/* 

has executed fork, but no exec */ 

y/ d e f i n e 

ASU 

02 

/» 

used superuser privileges */ 

y/ d e f i n e 

ACCTF 

0300 

/» 

record type; 00 = acct */ 


In ac flag , the AFORK flag is turned on by each f o r k ( 2 ) and 
turned off by an ex ec ( 2 ) . The ac comm field is inherited 
from the parent process and is reset by any exec . Each time 
the system charges the process with a clock tick, it also 
adds to ac mem the current process size, computed as fol- 
lows : 

(data size) + (text size) / (number of in-core 

processes using text) 

The value of ac me m/( ac stime + ac utime ) can be viewed as an 
approximation of the mean process size, as modified by 
text- sharing . 
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The structure tacct.h, which resi'ies with the source files 
of the accounting commanHs, represents the total accounting 
format used by the various accounting commands: 


* total accounting (for acct period) , also for dav 

»/ 

structtacct{ 


u i d_^t 


t a__ 

ui d ; 

/» 

userid * / 


char 


ta__ 

name[ 8 ] ; 

/» 

login name */ 


float 


ta__ 

cpu[2 ] ; 

/« 

cum, cpu time, p/np 

(mins) * / 

float 


ta_ 

kcor e[ 2 ] ; 

/» 

cum kcor e-minutes , 

p/np * / 

float 


ta_ 

con[ 2 ] ; 


cum. connect time. 

p/ np , mins 

float 


t a__ 

du ; 

/« 

cum. disk usage */ 


long 


ta__ 

pc ; 

/» 

count of processes 

«/ 

unsigned 

short 

ta__ 

sc ; 

/» 

count of login sessions */ 

un si gned 

short 

t a 

d c ; 

/» 

count of disk samples */ 

unsigned 

sho r t 

ta 

fee; 

/* 

fee for special services */ 


SEE ALSO 

acct(IH), acctcom(l), acct(2). 

BUGS 

tne m value for a short-lived command gives little 
information about the actual size of the command, because 
ac me m may be incremented while a different command (e.g., 
the shell) is being executed by the process. 
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NAME 

aouthdr - optional aout header 
SYNOPSIS 

linclude <aouthdr,h> 

DESCRIPTION 

An object file may contain an optional header, following the 
file header described in f i 1 ehd r ( 4 ) . Object files that have 
been completely linked by 1^(1) contain this header; others 
do not. The format of the optional header is: 

typedef struct aouthdr { 


short 

magic; 

/» 

magic number 

*/ 




short 

V St amp ; 

/* 

version stamp 





long 

t si ze ; 

/* 

text size in 

bytes 

, padded 

C .text) 

long 

d si ze ; 

/* 

initialized data ( 

.data) * / 



long 

b si ze ; 

/* 

uninitialized 

data 

( .bss) */ 


long 

entry; 

/* 

entry point */ 




long 

te X t_^st ar t ; 

/* 

base of text 

used 

for this 

file 

*/ 

long 

data_start ; 

/» 

base of data 

used 

for this 

file 

»/ 


} AOUTHDR; 

SEE ALSO 

a.out(M), filehdr(4). 
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MAME 

ar -- common archive file format 


DESCRIPTION 

The archive command ^ is used to combine several files into 
one. Archives are used mainly as libraries to be searched 
by the link editor 1 d ( 1 ) . 

Each archive begins with the archive magic string. 

Idefine ARMAG "!<arch>\n’' magic string */ 

Idefine SARMAG 8 /• length of magic string */ 

Each archive which contains common object files (see 
a . o ut ( M ) ) includes an archive symbol table. This symbol 
table is used by the link editor 1 ) to determine which 
archive members must be loaded during the link edit process. 
The archive symbol table (if it exists) is always the first 
file in the archive (but is never listed) and is automati- 
cally created and/or updated by ar . 

Following the archive magic string are the archive file 
members. Each file member is preceded by a file member 
header which is of the following format: 


Idefine ARFMAG \n" J* header trailer string */ 


struct ar^^hdr 
{ 

char ar__name[ 1 6 ] ; 
char ar_^date[ 1 2 ] ; 
char ar__uid[6]; 
char ar^gid[6]; 
char ar__modeC8]; 
char ar~size[10]; 
char ar fmag[2]; 


/* file member header */ 

/* '/' terminated file member name */ 

/♦ file member date */ 

/* file member user identification */ 

/* file member group identification */ 
/* file member mode */ 

/* file member size */ 

/* header trailer string */ 


All information in the file member headers is in printable 
ASCII. The numeric information contained in the headers is 
stored as decimal numbers (except for ar mode which is in 
octal). Thus, if the archive contains printable files, the 
archive itself is printable. 

The ar name filed is blank-padded and slash (/) terminated. 

ah date field is the modification date of the file at 
the time of its insertion into the archive. Common format 
archives can be moved from system to system as long as the 
portable archive command ^(1) is used. 

Each archive file member begins on an even byte boundary; a 
newline is inserted between files if necessary. Neverthe- 
less, the size given reflects the actual size of the file 
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exclusive of pad'iing. 

Notice there is no provision for empty areas in an archive 
file. 

If the archive symbol table exists, the first file in the 
archive has a zero length name (i.e., ar^name[0] = 

The contents of this file are as follows: 

® The number of symbols. Length: 4 bytes. 

9 The array of offsets into the archive file. Length: 4 

bytes * ''the number of symbols'*. 

9 The name string table. Length: ar si ze t- (4 bytes * 
(''the number of symbols’’ +1)). The number of symbols 
and the array of offsets are managed with sg e tl and 
sput 1 . The string table contains exactly as many null 
terminated strings as there are elements in the offsets 
array. Each offset from the array is associated with 
the corresponding name from the string table (in order). 
The names in the string table are all the defined global 
symbols found in the common object files in the archive. 
Each offset is the location of the archive header for 
the associated symbol. 

SEE ALSO 

ar(1), Id ( 1 ) , strip(l), sputl(3X), a,out(4). 

WARNINGS 

St r i p ( 1 ) will remove all archive symbol entries from the 
header. The archive symbol entries must be restored via the 
S option of the _ar ( 1 ) command before the archive can be used 
with the link editor Id ( 1 ) . 
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NAME 

checklist - list of file systems processed by fsck 
DESCRIPTION 

Checklis t resides in directory /etc and contains a list of 
at most 15 special f i 1 e n ames . Each spec ia 1 f i 1 e name is con- 
tained on a separate line and corresponds to a file system. 
If no f i 1 e - system argument is provided to f s c k ( 1 M ) , each 
file listed in / etc / checkl i st is automatically read and 
checked for inconsistencies. 

SEE ALSO 

f sc k( 1 M ) . 
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NAME 

core - format of core image file 
DESCRIPTION 

The system writes out a core image of a terminated process 
when any of various errors occur. SignaK P) describes rea- 
sons for errors. The most common errors are memory viola- 
tions, illegal instructions, bus errors, and user-generated 
quit signals. The core image is called core and is written 
in the working directory of the process (provided it can be; 
normal access controls apply). A process with an effective 
user ID different from the real user ID will not produce a 
core image. 

The first section of the core image is a copy of the 
system’s per-user data for the process, including the regis- 
ters as they were at the time of the fault. The size of 
this section depends on the parameter us i ze , which is 
defined in / usr / inc lud e/ sys/ par am . h . The remainder 
represents the actual contents of the user’s core area when 
the core image was written. If the text segment is read^ 
only and shared, or separated from data space, it is not 
d urn ped . 

The format of the information in the first section is 
described by the user structure of the system, defined in 
/usr/include/sys/user .h . The locations of the registers are 
outlined in / usr / incl ud e/ sys/ r eg , h . 

SEE ALSO 

crash(IM), sdb(1), setuid(2), signal(2). 
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NAME 

cpio - format of cpio archive 
DESCRIPTION 

When the *.c option of c pi o ( 1 ) is not used, the file header 
structure is: 

struct { 

short h_mag ic , 

h^dev ; 
ushort h__ino, 

h__mod e , 
h_ui d , 
h_gid ; 

short h__nlink, 

h__rd e V , 
h__mt ime [ 2 3, 
h_^namesi ze , 
h_^f i lesize[2]; 

char h__name[ h__namesi ze rounded to word]; 

} Hd r ; 

When the -c option is used, the header information is 
described by : 

sscanf ( Chdr ,"? 6 o% 6 o 5 & 6 o? 6 o$ 6 o% 6 o% 60 X 60 % 1 1 lo%6o%1 1 lo%s" , 

& Hd r . h_mag i c , &Hdr.h__dev, &Hdr.h__ino, &Hdr.h_mode, 
&Hdr.h__uid, &Hdr.h__gid, & Hd r . h_nl in k , & Hd r . h__rd e v , 
&Longtime, & Hd r . h__name si ze , &Long f i 1 e , Hd r . h_nara e ) ; 

Long time and Long f i 1 e are equivalent to Hd r . h mti me and 
Hdr . h filesize , respectively. The contents of each file are 
recorded in an element of the array of varying length struc- 
tures, archive , together with other items describing the 
file. Every instance of h magic contains the constant 
070707 (octal). The items h dev through h mtime have mean- 
ings explained in st a t ( 2 ) . The length of the null- 
terminated pathname h name , including the null byte, is 
given by h namesize . 

The last record of the archive always contains the name 
TRAILER!!!. Special files, directories, and the trailer are 
recorded with h filesize equal to zero. 

SEE ALSO 

cpio(l), find(1), stat(2). 
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NAME 

dir - format of directories 

SYNOPSIS 

linclude <3ys/dir.h> 

DESCRIPTION 

A directory behaves exactly like an ordinary file, except 
that no user may write into a directory. The fact that a 
file is a directory is indicated by a bit in the flag word 
of its inode entry (see Xs(M)), The structure of a direc- 
tory entry as given in the include file is: 

yafndef DIRSIZ 
//define DIRSIZ 14 

// en d i f 

struct direct 

{ 

ino__t d__^ino ; 

char d^name[DIRSIZ ] ; 

}; 

By convention, the first two entries in each directory are 
for , and ... The first is an entry for the directory 
itself. The second is for the parent directory. The mean- 
ing of .. is modified for the root directory of the master 
file system; because there is no parent, has the same 

meaning as , . 


SEE ALSO 

fs(4) . 
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NAME 

errfile -- error-r-log file format 
DESCRIPTION 

When har<iware errors are detected by the system, an error 
record is generated and passed to the error-logging daemon 
for recording in the error log for later analysis. The 
default error log is /usr/adm/err f i le . 

The format of an error record depends on the type of error 
that was encountered. Every record, however, has a header 
with the following format: 

struct errhdr { 

sho r t e__type ; 

short e_len ; 

time__t e__time; 

}; 

The permissible record types are as follows: 

y/define ERGOTS 010, /• start for the UNIX/TS*/ 

//define E_G0RT 011 /« start for the UNIX/PT*/ 

//define E__ST0P 012 /* stop ♦/ 

//define E__TCHG OI 3 /* time change */ 

//define E_CCHG 014 /* configuration change »/ 

//define E__BLK 020 /* block device error */ 

//define E__STPAY 030 /• stray interrupt */ 

//define E__PPTY 03 I /* memory parity */ 

Some records in the error file are of an administrative 
nature. These include the startup record that is entered 
into the file when logging is activated, the stop record 
that is written if the daemon is terminated ''gracefully’’, 
and the tim.e-change record that is used to account for 
changes in the system’s time-of-day. These records have the 
following formats: 

struct estart { 
short 

struct utsname 

}; 

//define eend errhdr /* record header */ 

struct etimchg { 

time__t e__ntime;/* new time */ 

}; 


e__cpu; /* CPU type •/ 
e name;/* system names */ 


/* record type */ 

/* bytes in record (inc hdr) */ 
/* time of day */ 
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Stray interrupts cause a record with the following format to 
be logged: 

struct e str ay { 

uint e__saddr; /* stray loc or device addr */ 

} ; 

Generation of memory subsystem errors is not supported in 
this release. 

Error records for block devices have the following format: 
struct eblock { 


dev t 

e__dev ; 

/» 

" tr ue " 

major + minor dev no 

p h y s a d r 

e__r eg loc ; 

/» 

controller address */ 

short 

e bac t y ; 

/* 

other block I/O activity */ 

struct lost at 

{ 




long 

io___ops ; 

/» 

number 

r ead / wr i te s * / 

long 

io_mi sc ; 

/* 

nura ber 

’’other" operations */ 

u sho r t 

io__unlog ; 

/» 

number 

unlogged errors */ 

} 

e stats; 




short 

e__b f 1 ag s ; 

/» 

read/write, error, etc */ 

short 

e^cylof f ; 

/* 

logical 

dev start cyl */ 

d ad d r t 

e bnum ; 

/» 

logical 

block number */ 

u s h 0 r t 

e bytes; 

/» 

number 

bytes to transfer */ 

p a d d r__ t 

e__mem add ; 

/« 

buffer 

memory address •/ 

u s h 0 r t 

e__r tr y ; 

/« 

number 

retries */ 

short 

e_nr eg ; 

/» 

number 

device registers */ 


} ; 

The following values are used in the e bflags word: 


# d e f i n e 

E 

WRITE 

0 

/* 

write operation */ 

y/ d e f i n e 

e" 

READ 

1 

/* 

read operation */ 

//define 

e” 

NOIO 

02 

/» 

no I/O pending */ 

//define 

e“ 

PHYS 

04 

/» 

physical I/O */ 

//define 

e" 

FORMAT 

01 0 

/« 

Formatting Disk*/ 

//define 

e” 

ERROR 

020 

/♦ 

I/O failed »/ 


SEE ALSO 

er rd emon( 1 M ) . 
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NAME 

filehdr - file header for common object files 

SYNOPSIS 

linclude <filehdr.h> 

DESCRIPTION 

Every common object file begins with a 20-r.byte header. The 
following C struct declaration is used: 

struct filehdr 

{ 

‘ unsigned short 

unsigned short 
long 
long 
long 

unsigned short 
unsigned short 

} ; 

F symptr is the byte offset into the file at which the sym- 
bol table can be found. Its value can be used as the offset 
in f see k ( 3S ) to position an I/O stream to the symbol table. 
See ao ut hd r ( M ) for the structure of the optional aout 
header. The valid magic number is: 

//define MC68MAGIC 0520 /* magic number */ 

The value in f ti md a t is obtained from the time C 2 ) system 
call. Flag bits currently defined are: 

//define F__PELFLG 00001 /* relocation entries stripped */ 

//define F__EXEC 00002 /* file is executable */ 

//define F_LNN0 00004 /* line numbers stripped */ 

//define F__LSYMS 0001 0 /* local symbols stripped */ 

//define F^MINMAL 00020 /* minimal object file */ 

//define F__UPDATE 00040 /* update file, ogen produced */ 

//define F__^SWABD 001 00 /* file is *' pr e-swabbed *' */ 

//define F_AR16WP 00200 /» 16-bit DEC host »/ 

//define F_AP32WP 00400 /* 32-bit DEC host »/ 

//define f2aP 32W 01 000 /» non-DEC host */ 

//define F_PATCH 02000 /* "patch” list in opt hdr »/ 

SEE ALSO 

time(2), fseek(3S), a.out(4), aouthdr(4). 


f__magic ; /• magic number */ 

f__nscns ; /* number of sections */ 

f^timdat ; /* time & date stamp */ 
f__syraptr ; /• file ptr to symtab */ 
f__nsyms ; /* // symtab entries */ 

f_opthdr ; /* sizeofCopt hdr) */ 

f flags ; /* flags */ 


- 1 


Printed 6 1985 



FSCM) 


FS(4) 


NAME 

file system - format of system volume 
SYNOPSIS 

finclude < sys/ f i 1 sys .h> 
i/include < sys/ type s .h> 
i^include < sys/ par am .h> 

DESCRIPTION 

Every file system storage volume has a common format for 
certain vital information. Every such volume is divided 
into a certain number of 512*'byte long sectors. Sector 0 is 
unused and is available to contain a bootstrap program or 
other information. 


Sector 1 is the super block . The format of a superblock is: 


/* 

* Structure of the superblock 

*/ 


struct 

f 

1 


}; 

//define 

//define 

//define 


f i 1 sys 


u s h 0 r t 

s_ 

i si ze ; 

/* 

d ad d r t 

s_ 

f s i ze ; 

/» 

short 

s_ 

nfr ee ; 

/* 

d ad d r t 

s__ 

fr eeCNICFPEE] ; 

/* 

short 

s__ 

ninod e ; 

/» 

ino__t 

s__ 

inod e[ NICINOD] ; 

/» 

char 

s__ 

flock; 

/» 

char 

s__ 

i 1 oc k ; 

/* 

char 

s___ 

fmod ; 

/» 

char 

s_ 

ronl y ; 

/* 

time t 

s_ 

time; 

/* 

short 

s__ 

d in fo [ 4 ] ; 

/» 

d ad d r t 

s__ 

t f r ee ; 

/* 

i no_t 

s__ 

t i nod e ; 

/» 

char 

s__ 

fn ame [ 6 3 ; 

/* 

char 

s__ 

f packL 6 3 ; 

/» 

long 

s__ 

fill[133; 

/» 

long 

s__ 

magic; 

/» 

long 

s__ 

type ; 

/» 


FsMAGIC 

Oxfd 1 87e20 

/» 

Fs 1 b 

1 

/» 

Fs2b 

2 

/* 


size in blocks of i-list */ 
size in blocks of entire volume 
number of addresses in s__^fre€ ^ 
free block list 

number of inodes in s__inode */ 
free inode list */ 
lock during free list manipulat 
lock during i--list manipul atio.t 
superblock modified flag 
mounted read-only flag */ 
last superblock update */ 
device information */ 
total free blocks*/ 
total free inodes •/ 
file system name */ 
file system pack name */ 

ADJUST size of filsys to 512 */ 
magic number to indicate new fi 
type of new file system */ 


s magic number */ 
5T2-byte block «/ 
1024-byte block */ 


S type indicates the file system type. Currently, two types 
of file systems are supported: the original 512-byte 
oriented and the new improved 1024-byte oriented. S magic 
is used to distinguish the original 512-byte oriented file 
systems from the newer file systems. If this field is not 
equal to the magic number, FsMAGI C , the type is assumed to 
Fs 1 b , otherwise the s type field is used. In the 
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following description, a block is then determined by the 
type. For the original 512-byte oriented file system, a 
block is 512 bytes. For the 1024-byte oriented file system, 
a block is 1024 bytes or two sectors. The operating system 
takes care of all conversions from logical block numbers to 
physical sector numbers. 

S i s i z e is the address of the first data block after the i- 
list; the i*>list starts just after the super-block, namely 
in block 2; thus the i-list is s i si ze -2 blocks long. 
S f s i ze is the first block not potentially available for 
allocation to a file. These numbers are used by the system 
to check for bad block numbers; if an ''impossible’’ block 
number is allocated from the free list or is freed, a diag- 
nostic is written on the on-line console. Moreover, the 
free array is cleared, so as to prevent further allocation 
from a presumably corrupted free list. 

The free list for each volume is maintained as follows. The 

s fr ee array contains, in s fr ee [ 1 3 , s fr ee [ s nf r ee - 1 ] , 

up to 49 numbers of free blocks. S f r ee [ 0 ] is the block 
number of the head of a chain of blocks constituting the 
free list. The first long in each free-chain block is the 
number (up to 50) of free-block' number s listed in the next 
50 longs of this chain member. The first of these 50 blocks 
is the link to the next member of the chain. To allocate a 
block; decrement s nfree , and the new block is 
s free [ s nfree ]. If the new block number is 0, there are no 
blocks left, so give an error. If s nfree became 0, read in 
the block named by the new block number , replace s nfree by 
its first word, and copy the block numbers in the next 50 
longs into the s fr ee array. To free a block, check if 


s 

nfree is 

50; 

if so 

, copy s__ 

nfree and the 

s fr ee 

ar r ay 

into 

it 

, write 

i t 

out , 

and set 

s nfree to 0. 

In an y 

event set 

s 

fr ee[ s nfree] 

to the freed 

block’s number and 

increment 

s 

nfree. 








S 

t f r ee is 

the 

to tal 

free blocks available 

in the 

file 

sys- 

tern . 








S__ 

ninode is 

the 

number of free i-numbers 

in the 

inod e 


array. To allocate an inode; if s ninode is greater than 0, 
decrement it and return s inod e [ s' ninod e j . If it was 0, 
read the i-list and place the numbers of all free inodes (up 
to 100) into the s inode array, then try again. To free an 
inode, provided s ninode is less than 100, place its number 
s inod e [ s ninode ] and increment s ninode . If s ninode 
is already 100, do not bother to enter the freed inode into 
any table. This list of inodes is only to speed up the 
allocation process; the information as to whether the inode 
is really free or not is maintained in the inode itself. 

S tinode is the total free inodes available in the file sys- 
tem . 
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S flock and s i I oc k are flags maintained in the core copy of 
the file system while it is mounted and their values on disk 
are immaterial. The value of s fmod on disk is likewise 
immaterial; it is used as a flag to indicate that the 
super-block has changed and should be "copied to the disk 
during the next periodic update of file system information. 

S ronly is a read-only flag to indicate write-protection, 

S time is the last time the super-block of the file system 
was changed, and is the number of seconds that have elapsed 
since 00:00 Jan. 1, 1970 (GMT). During a reboot, the s time 

of the super-block for the root file system is used to set 
the system’s idea of the time, 

S fname is the name of the file system and s fpack is the 
name of the pack. 

T-numbers begin at 1, and the storage for inodes begins in 
block 2. Also, inodes are 6M bytes long. Inode 1 is 
reserved for future use. Inode 2 is reserved for the root 
directory of the file system, but no other i-number has a 
built-in meaning. Each inode represents one file. For the 
format of an inode and its flags, see inod e ( M ) . 

FILES 

/usr/include/sys/filsys .h 
/usr/include/sys/stat .h 

SEE ALSO 

fsck(IM), fsdb(IM), mkfs(IM), inode(4). 
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NAME 

fspec - format specification in text files 
DESCRIPTION 

It is sometimes convenient to maintain text files on the 
UNIX System with non-standard tabs* (i.e,, tabs which are 
not set at every eighth column). Such files must generally 
be converted to a standard format, frequently by replacing 
all tabs with the appropriate number of spaces, before they 
can be processed by UNIX System commands, A format specifi- 
cation occurring in the first line of a text file specifies 
how tabs are to be expanded in the remainder of the file. 

A format specification consists of a sequence of parameters 
separated by blanks and surrounded by the brackets <: and 
:>. Each parameter consists of a keyletter, possibly fol- 
lowed immediately by a value. The following parameters are 
recognized ; 

t t ab s The t parameter specifies the tab settings for 
the file. The value of tabs must be one of the 
following : 

1. a list of column numbers separated by com- 
mas, indicating tabs set at the specified 
columns; 

2. a - followed immediately by an integer ji , 
indicating tabs at intervals of n columns; 

3. a - followed by the name of a "canned’’ tab 
specification. 

Standard tabs are specified by t-8 , or 
equivalently, 1 1 , 9 , 1 7 , 25 , e tc . The canned tabs 
which are recognized are defined by the tab s ( 1 ) 
comm and . 

3 S i ze The s parameter specifies a maximum line size. 

The value of size must be an integer. Size 
checking is performed after tabs have been 
expanded, but before the margin is prepended, 

m m ar g in The m parameter specifies a number of spaces to 
be prepended to each line. The value of margin 
must be an integer. 

d The d parameter takes no value. Its presence 

indicates that the line containing the format 
specification is to be deleted from the converted 
file. 

e The e parameter takes no value. Its presence 

indicates that the current format is to prevail 
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only until another format specification is 
encountered in the file. 

Default values, which are assumed for parameters not sup- 
plied, are t-8 and mO . If the s parameter is not specified, 
no size checking is performed. If the first line of a file 
does not contain a format specification, the above defaults 
are assumed for the entire file. The following is an exam- 
ple of a line containing a format specification: 

* <:t5 , 10, 15 s72: > * 

If a format specification can be disguised as a comment, it 
is not necessary to code the d parameter. 

SEE ALSO 

ed ( 1 ) , newform(l), tabs(l). 
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NAME 

gettydefs - speed and terminal settings used by getty 
DESCRIPTION 

The / etc/gettyd efs file contains information used by 
g e 1 1 y ( 1 M ) to set up the speed and terminal settings for a 
line. It supplies information on what the login prompt 
should look like. It also supplies the speed to try next if 
the user indicates the current speed is not correct by typ- 
ing a < br eak > character. 

Each entry in / etc/ gettyd efs has the following format: 

label// initial-flags // final-flags // log in- prompt //next- 
label 

Each entry is followed by a blank line. Lines that begin 
with # are ignored and may be used to comment the file. The 
format fields can contain quoted characters of the form \b, 
\n, \c, etc., as well as \ nnn , where nnn is the octal value 

of the desired character. The fields are: 

label This is the string against which g e 1 1 y ( 1 M ) 

tries to match its second argument. It is 
often the speed at which the terminal is sup- 
posed to run, e.g., 1200, but it needn't be. 

If g e 1 1 y ( 1 M ) is called without a second argu- 
ment, then the first entry of /etc/gettydefs 
is used, thus making the first entry of 
/etc/gettydefs the default entry. The first 
entry is also used if getty ( 1 M) can't find 
the specified label . If /etc/gettydefs 
itself is missing, there is one entry built 
into the comm and which will bring up a termi- 
nal at 300 baud . 

initial - flags These flags are the initial ioc tl ( 2 ) settings 
to which the terminal is to be set if a ter- 
minal type is not specified to getty ( 1 M) . 
Getty ( 1 M) understands the symbolic names 
specified in /usr/ incl ud e/ sys/ termio ,h (see 
t erm io ( 7 ) . Normally only the speed flag is 

required in the initial - flags field, 

Ge tty ( 1 M) automatically sets the terminal to 
raw input mode and takes care of most of the 
other flags. The in i ti a 1 - f 1 ag settings 
remain in effect until getty ( 1 M) executes 
login C 1 ) . 

f in al - f 1 ag s These flags take the same values as the 

in i ti al - flags and are set just before 

getty ( 1 M) executes log in ( 1 ) . The speed flag 
is again required. The composite flag SANE 
takes care of most of the other flags that 
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need to be set so that the processor and ter*^ 
minal communicate in a rational fashion. The 
other two commonly specified final ^ flags are 
TAB3 (tabs are sent to the terminal as 
spaces) and HUPCL (the line is hung up on the 
finalclose). 

1 og in - prompt This entire field is printed as the login - 
prompt . White-space characters (space, tab, 
and new-line) are included in this field, 
unlike the other fields in which white space 
i s i gno r ed . 

next - label This field indicates the next entry label in 

the table that ge tty ( 1 M) should use if the 
user types a < br eak > or the input cannot be 
read. Usually, a series of speeds are linked 
together in a closed set. No matter where 
the set is entered, the correct speed can be 
obtained. For example, 2400 is linked to 
1200, which in turn is linked to 300, which 
finally is linked to 2400. 

After making or modifying /etc/gettydefs , it is strongly 

recommended that the file be run through getty ( 1M) with the 

check option to be sure there are no errors. 

FILES 

/etc/gettydefs 

SEE ALSO 

getty(IM), termio(7), login(1), ioctl(2). 
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NAME 

gps - graphical primitive string, format of graphical files 
DESCRIPTION 

GPS is a format used to store graphical data. Several rou- 
tines have been developed to edit and display GPS files on 
various devices. Also, higher level graphics programs such 
^ stat e 1G ) ) and v toe (in toe ( 1 G ) ) produce GPS for- 
matoutputfiles. 

A GPS is composed of five types of graphical data or primi- 
tives. 

GPS PRIMITIVES 

lines The lines primitive has a variable number of 

points from which zero or more connected line seg- 
ments are produced. The first point given pro- 
duces a move to that location. (A mov e is a relo- 

cation of the graphic cursor without drawing.) 
Successive points produce line segments from the 
previous point. Parameters are available to set 
color , weight , and st yl e (see below). 

arc The ar c primitive has a variable number of points 

to which a curve is fit. The first point produces 
a mov e to that point. If only two points are 
included, a line connecting the points will 

result. If three points are included, a circular 
arc through the points is drawn. If more than 
three points are included, lines connect the 

points. (In the future, a spline will be fit to 
the points if they number greater than three.) 
Parameters are available to set color , weight , and 
style , 

text The text primitive draws characters. It requires 

a single point which locates the center of the 
first character to be drawn. Parameters are 
color , fon t , tex t si ze , and tex tangle . 

hardware The hardware primitive draws hardware characters 
or gives control commands to a hardware device. A 
single point locates the beginning location of the 
hardware string. 

comment A comm en t is an integer string that is included in 
a GPS file but causes nothing to be displayed. 
All GPS files begin with a comment of zero length. 

GPS PARAMETERS 

color Color is an integer value set for arc , lines , and 

text primitives. 
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weight Weight is an integer value set for ar c anH lines 
primitives to indicate line thickness. The value 
0 is narrow weight, 1 is bold weight, and 2 is 
medium weight. 

style Style is an integer value set for lines and arc 

primitives to give one of the five different line 
styles that can be drawn on Tektronix M010 series 
storage tubes. They are: 

0 solid 

1 dotted 

2 dot dashed 

3 dashed 

M long dashed 

font An integer value set for text primitives to desig--- 

nate the text font to be used in drawing a charac- 
ter string. (Currently font is expressed as a 

weight value followed by a 4-bit st yl e value.) 

tex t si ze Tex t si ze is an integer value used in text primi- 
tives to express the size of the characters to be 
drawn. Tex tsi ze represents the height of charac- 
ters in absolute un i v er se - un its and is stored at 
one-fifth this value in the size-orientation ( so ) 
word (see below). 

textangle Tex tang le is a signed integer value used in text 
primitives to express rotation of the character 
string around the beginning point. Tex tangle is 
expressed in degrees from the positive x-axis and 
can be a positive or negative value. It is stored 
in the size-orientation C^) word as a value 
256/360 of its absolute value. 

ORGANIZATION 

GPS primitives are organized internally as follows: 

lines c_w points s w 

arc £w points ^w 

text £w point sw so [ string ] 

hardware £w point [ string ] 
comment £w [ string ] 

cw is the control word and begins all primitives. 

It consists of 4 bits that contain a primitive- 
type code and 12 bits that contain the word-count 
for that primitive. 

polnt(5) Po in t ( s ) is one or more pairs of integer coordi- 
nates. Text and hardware primitives only require 
a single point . Poin t ( s) are values within a 
Cartesian plane or un iv er se having 64K (-32K to 
+32K) points on each axis. 
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sw 


so 


string 


Sw is the style-word and is used in lines , arc , 
X ^ primitives. The first 8 bits contain 
color information. In ar c and lines the last 8 
bits are divided as 4 bits weight and 4 bits 
style . In the text primitive the last 8 bits of 
s w contain the font . 

So is the size-orientation word used in text prim- 
itives. The first 8 bits contain text size (see 
te X t si ze ) and the remaining 8 bits contain text 
rotation (see tex tangle ) . 

Str in g is a nul 1-term in a ted character string. If 
the string does not end on a word boundary, an 
additional null is added to the GPS file to assure 
word-boundary alignment. 


SEE ALSO 

g r aph i c s ( 1 G ) 
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NAME 

group - group file 
DESCRIPTION 

Group contains the following information for each group: 

group name 
encrypted password 
numerical group ID 

comm a- se par a ted list of all users allowed in the group 

This is an ASCII file. The fields are separated by colons; 
each group is separated from the next by a new-line. If the 
password field is null, no password is demanded. 

This file resides in directory /etc. Because of the 
encrypted passwords, it can and does have general read per- 
mission and can be used, for example, to map numerical group 
IDs to names . 


FILES 

/ et c / gro up 


SEE ALSO 

newgrp(l), passwd(l), crypt(3C), passwd(M). 
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NAME 

inittab - script for the init process 

DESCRIPTION 

The /etc/inittab file supplies the script for i n i t ( 1 M ) to 
perform as a general process dispatcher. The process that 
constitutes the majority of init ’ s process dispatching 
activities is the line process / etc / getty ^ which initiates 
individual terminal lines. Other processes typically 
dispatched by init are daemons and the shell, 

NOTE: V/ithin this section, the term init always refers to 

the program described in i n i t ( 1 M ) , 

The inittab file is composed of entries that are position- 
dependent and have the following format; 

id irstate :action:process 

Each entry is delimited by a new-line; however, a backslash 
(\) preceding a new-line indicates a continuation of the 
entry. Up to 512 characters per entry are permitted. Com- 
ments may be inserted in the process field using the sh ( 1 ) 
convention for comments. Comments for lines that spawn 
get ty s are displayed by the who ( 1 ) command. It is expected 
that they will contain some information about the line such 
as the location. There are no limits (other than maxim urn 
entry size) imposed on the number of entries within the 
inittab file. The entry fields are: 

i d This field is 1 to 4 characters used to uniquely 

identify an entry, 

r state This field defines the run - level in which this 
entry is to be processed. Run - lev el s effectively 
correspond to a configuration of processes in the 
system. That is, each process spawned by init is 
assigned a run - level or run- level s in which it is 
allowed to exist. The run - level s are represented 
by a number ranging from 0 through 6 , As an exam- 
ple, if the system is in run - lev el 1, only those 
entries having a 1 in the r state field will be 
processed. When init is requested to change run - 
levels , all processes which do not have an entry 
in the r state field for the target run - level will 
be sent the warning signal (SIGTERM) and allowed a 
20-second grace period before being forcibly ter- 
minated by a kill signal (SIGKILL). The r state 
field can define multiple run - level s for a process 
by selecting more than one r un - level in any combi- 
nation from 0-6. If no run - level is specified, 
action will be taken on this process for all r un- 
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action 


/ 


1 e V e ls , 0-6. There are three other values, a, b, 

and c, which can appear in the r state field, even 
though they are not true r un- lev el s , Entries 
which have these characters in the r s ta te field 
are processed only when the te 1 in i t (see in i t ( 1 M ) ) 
process requests them to be run (regardless of the 
current r un - le v el of the system). They differ 
from run - 1 ev el s in that the system is only in 
these states for as long as it takes to execute 
all the entries associated with the states, A 
process started by an a, b, or c command is not 
killed when in i t changes levels. They are only 
killed if their line in /etc/inittab is marked off 
in the action field, their line is deleted 
entirely from /etc/inittab, or in i t goes into the 
S IN GLE jjSEP state. 

Key words in this field tell in i t how to treat the 
process specified in the process field. The 
actions recognized by i n i t are as follows: 

respawn If the process does not exist, i n i t 

is to start the process, not wait 
for its termination (continue scan- 
ning the in i 1 1 ab file), and, when it 
dies, restart the process. If the 
process currently exists i n i t is to 
do nothing and continue scanning the 
in i t tab file, 

wait When i n i t enters the r un - le v el that 

matches the entry’s r s t a te , it is to 
start the process and wait for its 
termination. All subsequent reads 
of the in i t tab file while in i t is in 
the same run - level will cause in i t 
to ignore this entry. 

onoe When in i t enters a run - level that 

matches the entry’s r state , it is to 
start the process, not wait for its 
termination and, when it dies, not 
restart the process. If a new r un - 
1 ev el is entered when the process is 
still running, the program will not 
be restar ted , 


boot The entry is to be processed only at 

in i t * s boot-time read of the in i ttab 
file. In i t is to start the process, 
not wait for its termination, and, 
when it dies, not restart the 
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boo twai t 


power fail 


power wait 


off 


ond emand 


initdefault 


process. In order for this instruc- 
tion to be meaningful, either the 
r s t a t e should be the default or it 
must match i n i t * s run- lev el at boot 
time. This action is useful for an 
initialization function following a 
hardware reboot of the system. 

The entry is to be processed only at 
in i t * s boot-time read of the in i t tab 
file. Ini t is to start the process, 
wait for its termination, and, when 
it dies, not restart the process. 

In i t is to execute the process asso- 
ciated with this entry only when it 
receives a powerfail signal (SIGPWF; 
see si gnal ( 2 ) ) , 

In i t is to execute the process asso- 
ciated with this entry only when it 
receives a powerfail signal (3IGPWR) 
and is to wait until the process 
terminates before continuing any 
processing of in i ttab , 

If the process associated with this 
entry is currently running, in i t is 
to send the warning signal (SIGTERM) 
and wait 20 seconds before forcibly 
terminating the process via the kill 
signal (SIGKILL). If the process is 
nonexistent, in i t is to ignore the 
entry. 

This instruction is really a synonym 
for the respawn action. It is func- 
tionally identical to respawn but is 
given a different keyword in order 
to divorce its association with 
run - level s , This is used only with 
the a, b, or c values described in 
the rstate field. 


An entry with this action is scanned 
only when in i t is initially invoked. 
In i t uses this entry, if it exists, 
to determine which r un - le v el to 
enter initially. It does this by 
taking the highest run - lev el speci- 
fied in the rstate field and using 
that as its initial state. If the 
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r st a t e field is empty, this is 
interpreted as 0123^56 and in i t will 
enter run - lev el 6. If the initde- 
fault entry is s, i n i t will start in 
user state. If init 
doesn't find an initdefault entry in 
/etc/inittab , it will request an 
initial run - level from the user at 
reboot time, 

sysinit Entries of this type are executed 

before ini t tries to access the con- 
sole, It is expected that this 
entry will be only used to initial- 
ize devices on which init might try 
to ask the run - level question. 
These entries are executed and 
waited for before continuing, 

process This is a _sh command to be executed. The entire 
process field is prefixed with exec and passed to 
a forked ^ as sh -c 'exec command ' , For this 
reason, any legal _sh syntax can appear in the the 
process field. Comments can be inserted with the 
; # comment syntax. 


FILES 

/etc/inittab 

SEE ALSO 

getty(IM), init(IM), sh(1), who(l), exec(2), open(2), sig- 
nal ( ? ) , 
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NAME 

inode - format of an inode 
SYNOPSIS 

linclude < sys/ type s .h> 

#include <sys/ino.h> 

DESCRIPTION 

An inode for a plain file or directory in a file system has 
the following structure defined by <sys/ino.h>. 

/* Inode structure as it appears on a disk block. */ 
struct d inod e 
{ 


usho r t 

d i 

mod e ; 

/« 

mod e 

and type of file */ 

short 

d i 

nl ink ; 

/* 

number of links to 

file */ 

ushor t 

d i 

ui d ; 

/* 

owner 

’s user id */ 


usho r t 

d i 

gid ; 

/* 

owner 

’ s group id * / 


of f__t 

d i 

si ze ; 

/* 

number of bytes in 

file */ 

char 

d i___ 

add r [ 40 ] ; 

/« 

disk 

block addresses */ 

time t 

d i 

at i me ; 

/» 

time 

last accessed 

»/ 

time t 

d i 

mtime ; 

/» 

time 

last modified 


time t 

d i__ 

c time ; 

/» 

time 

created */ 



}; 

/* 

* the 40 address bytes; 

* 39 used; 13 addresses 

* of 3 bytes each. 

»/ 

For the meaning of the defined types off t and time t , see 
types ( 5 ) . 


FILES 

/usr/include/sys/ino.h 


SEE ALSO 

stat(2), fs(4), types(5). 
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NAME 

issue - issue identification file 


DESCRIPTION 

The file /etc/issue contains the issue or project 
cation to be printed as a login prompt. This is 
file which is read by getty ( 1 M) and then written to 
minal spawned or respawned from the lines file. 


FILES 

/ etc / i ssue 

SEE ALSO 

gettyC 1H) , login( 1 ) . 


i d en ti f i- 
an ASCII 
any ter- 
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NAME 

linenum -- line number entries in a common object file 
SYNOPSIS 

#include <linenuin,h> 

DESCRIPTION 


The C compiler 

generates 

an entry 

in the 

object file 

for 

each C 

source 

line on 

which a breakpoint 

is possible 

(when 

invoked 

with the ••g option; see 

cc ( 1 ) ) . 

Users can 

then 

refer ence line 

number s 

when using the appropriate software 

test system (see sdb(1)). The 

structure 

of these 

line 

number 

entries 

appears below. 




struct 

{ 

1 ineno 

union 

{ 

long 

l^symndx ; 






long 

l_paddr ; 





} 


l^addr ; 




} ; 

unsigned short 

l^lnno ; 





Numbering starts with one for each function. The initial 
line number entry for a function ha s 1 Inno equal to zero, 
and the symbol table index of the function’s entry is in 
1 symnd X . Otherwise, 1 Inno is non-'zero, and 1 paddr is the 
physical address of the code for the referenced line. Thus 
the overall structure is the following; 


1 ad d r 


1 Inno 

f unc tion 

symtab index 

0 

physical 

add r ess 

line 

physical 

ft • • 

address 

line 

function 

symtab index 

0 

ph ys i cal 

add r ess 

line 

physical 

add r ess 

line 


SEE ALSO 

cc(1), sdbCl), a.out(4) 
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NAME 

liifcn common object file access routines 
SYNOPSIS 

finclude <stdio,h> 
i^include <filehdr.h> 
i^include <ldfcn.h> 


DESCRIPTION 

The common object file access routines are a collection of 
functions for reading an object file that is in common 
object file form. Although the calling program must know 
the detailed structure of the parts of the object file that 
it processes, the routines effectively ins ul ate the calling 
program from knowledge of the overall structure of the 
object file. 

The interface between the calling program and the object 
file access routines is based on the defined type LDFILE 
(defined as struct Idfile), which is declared in the header 
file <ldfcn.h>. The primary purpose of this structure is to 
provide uniform access to both simple object files and 
object files that are members of an archive file. 

The function Id open ( 3X ) allocates and initializes the LDFILE 
structure and returns a pointer to the structure to the cal-- 
ling program. The fields of the LDFILE structure may be 
accessed individually through macros defined in <ldfcn,h> 
and contain the following information: 

LDFILE »ldptr; 

TYPE(ldptr) The file magic number, used to distinguish 
between archive members and simple object 
files. 

lOPTR(ldptr) The file pointer returned by f o pen ( 3S ) and 
used by the standard input/output functions. 

OFFSET ( Id ptr ) The file address of the beginning of the 
object file; the offset is non-zero if the 
object file is a member of an archive file. 

HEADER ( Id ptr ) The file header structure of the object file. 

The object file access functions may be divided into four 
categories: 

(1) functions that open or close an object file 

Id open ( 3X ) and Id ao pen 

open a common object file 
Id cl ose ( 3X ) and Id aclose 
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close a common object file 

(2) functions that rea(i header or symbol table infor- 
mation 

Id ahr ead ( 3 X ) 

read the archive header of a member of an 
archive file 
Id fhr ead ( 3 X ) 

read the file header of a common object file 
Id shr e ad ( 3X ) and Id nshr ead 

read a section header of a common object file 
Id tbr ead ( 3X ) 

read a symbol table entry of a common object 
file 

Idgetname C 3X ) 

retrieve a symbol name from a symbol table 
entry or from the string table 

(3) functions that position an object file at (seek 
to) the start of the section, relocation, or line 
number information for a particular section. 

ldohseek (3X) 

seek to the optional file header of a common 
object file 

Id sseek C 3X ) and Id nsseek 

seek to a section of a common object file 
ldrseek(3X) and Idnrseek 

seek to the relocation information for a sec- 
tion of a common object file 
Id 1 seek ( 3X ) and Id nl seek 

seek to the line number information for a 
section of a common object file 
Id tbseek C 3X ) 

seek to the symbol table of a common object 
file 

(M) the function Id tb ind ex ( 3X ) which returns the index 
of a particular common object file symbol table entry 

These functions are described in detail in the manual pages 
identified for each function. 

All the functions except Idopen , Id ao pen , and Idtbindex 
return either SUCCESS or FAILURE, which are constants 
defined in <ldfcn.h>. Ldopen and Id aopen both return 
pointers to a LDFILE structure. 

MACROS 

Additional access to an object file is provided through a 
set of macros defined in <ldfcn.h>. These macros parallel 
the standard input/output file reading and manipulating 
functions, translating a reference of the LDFILE structure 
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into a reference to its file descriptor field. 

The following macros are provided: 

GETC( Idptr ) 

FGETC(ldptr) 

GETW( Id ptr ) 

UNGETCCc, Idptr) 

FGETSCs, n, Idptr) 

FPEAD((char •) ptr, sizeof (*ptr), nitems, Idptr) 
FSEEKCldptr, offset, ptrname) 

FTELL( Id ptr) 

REWINDCldptr ) 

FEOF( Idptr) 

FEPROP (Idptr) 

FILENO ( Id ptr) 

SETBUFC Id ptr , buf) 

STROFFSET(ldptr) 

The STROFFSET macro calculates the address of the string 
table in a object file. See the manual entries for the 
corresponding standard input/output library functions for 
details on the use of these macros. (The functions are 
identified as 3S in Section 3 of this manual.) 

The program must be loaded with the object file access rou»- 
tine library libld.a. 


WARNINGS 

The macro FSEEK defined in the header file <ldfcn,h> 
translates into a call to the standard input/output function 
f seek ( 3S ) . FSEEK should not be used to seek from the end of 
an archive file since the end of an archive file may not be 
the same as the end of one of its object file members. 


SEE ALSO 

fopen ( 3S ) , 

Id fhr ead ( 3X ) , 
ldohseek(3X) , 
Id shr ead ( 3X ) , 
Common Object 


fseek(3S), Id ahr ead ( 3X ) , ldclose(3X), 

ldgetname( 3X ) , ldlread(3X), ldlseek(3X), 
ldopen(3X), ldrseek(3X), ldlseek(3X), 
Id tb ind ex ( 3X ) , Id thread ( 3X ) , Id tb seek( 3X ) . 

Fi 1 e Format, by I. S. Law. 
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NAME 

master - master device information table 
DESCRIPTION 

This file is used by the config C 1M) program to obtain device 
information that enables it to generate the configuration 
files. The file consists of 3 or 4 parts, each separated by 
a line with a dollar sign ($) in column 1, Part 1 contains 
device information; part 2 contains names of devices that 
have aliases; part 3 contains tunable parameter information. 
Part 4 is optional and contains information related to con- 
figuring the M68000 family systems only. Any line with an 
asterisk (*) in column 1 is treated as a comment. 

Part 1 contains lines consisting of at least 10 fields and 
at most 13 fields. The fields are delimited by tabs and/or 
blanks , 

Field 1: device name (8 chars, maximum). 

Field 2: interrupt vector size (decimal, in bytes). 

Field 3: device mask (octal)-each ''on'' bit indi- 

cates that the handler exists: 000100 
initialization handler 000040 power- 
failure handler 000020 open handler 

000010 close handler 000004 read handler 
000002 write handler 000001 ioctl 

handler 

Field 4: device type indicator (octal): 000200 

allow only one of these devices 000100 
suppress count field in the conf.c file 
000040 suppress interrupt vector 000020 
required device 000010 block device 

000004 character device 000002 interrupt 
driven device other than block or char, 
device 

Field 5; handler prefix (4 chars, maximum). 

Field 6: device address size (decimal). 

Field 7: major device number for block-type device. 

Field 8: major device number for character-type 

device. 

Field 9; maximum number of devices per controller 

(decimal) , 

Field 10: maximum bus request level (1 through 7). 
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Fields 11-13: optional configuration table structure 

declarations (8 chars, maximum) 

Part 2 contains lines with 2 fields each: 

Field 1: alias name of device (8 chars, maximum). 

Field 2: reference name of device (8 chars, max- 

imum; specified in part 1 ), 

Part 3 contains lines with 2 or 3 fields each: 


Field 1 : 


Field 2 : 


Field 3 : 


parameter name (as it 
appears in description 
file; 30 chars, max- 
imum.) 

parameter name (as it 
appears in the conf.c 
file; 30 chars, max- 
imum) 

default parameter 
value (30 chars, max- 
imum; parameter 
spec i fi cation i s 
required if this field 
is omitted) 


Part 4 contains M68000-speci fi c lines exactly like those for 
the M68000-spec i f i c portion of the dfile. See conf i g (1M) 
for a description of these lines. 

Devices that are not interrupt-driven have an interrupt vec- 
tor size of zero. The 040 bit in Field 4 causes conf i g ( 1 M ) 
to record the interrupt vectors although the m 68 kvec,s file 
will show no interrupt vector assignment at those locations 
(interrupts here will be treated as strays). 


SEE ALSO 

conf i g ( 1 M) . 
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NAME 


rnnttab - mounted file svstem table 


SYNOPSIS 

finclude <mnttab.h> 

DESCRIPTION 

Mnt tab resides in directory /etc and contains a table of 
devices, mounted by the moun t ( 1 M ) command, in the following 
structure as defined by <innttab.h>: 


str uc t 


}; 


rnnttab { 
char 
char 
short 
time t 


m t_^d ev [ 10]; 
mt_^filsys[10]; 
mt_ro_f Ig ; 
mt time ; 


Each entry is 26 bytes in length; the first 10 bytes are the 
null-padded name of the place where the special f i 1 e is 
mounted; the next 10 bytes represent the null-padded root 
name of the mounted special file; the remaining 6 bytes con- 
tain the mounted special file ’s read/write permissions and 
the date on which it was mounted. 

The maximum number of entries in rnnttab is based on the sys- 
tem parameter NMOUNT located in / usr / src/ut s/ c f / conf .c , 
which defines the number of allowable mounted special files. 


SEE ALSO 

mount(IM), setmnt(IM). 
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NAME 

passwd password file 
DESCRIPTION 

Pa sswd contains the following information for each user: 

login name 
encrypted password 
numerical user ID 
numerical group ID 

GCOS job number, box number, optional GCOS user ID 
initial working directory 
program to use as Shell 

This is an ASCII file. Each field within each user’s entry 
is separated from the next by a colon. The GCOS field is 
used only when communicating with that system, and in other 
installations can contain any desired information. Each 
user entry is separated from the next by a new-line. If the 
password field is null, no password is demanded; if the 
Shell field is null, the Shell itself is used. 

This file resides in directory /etc. Because of the 

encrypted passwords, it can and does have general read per- 
mission and can be used, for example, to map numerical user 
IDs to names. 

The encrypted password consists of 13 characters chosen from 
a 64-character alphabet (., /, O -9 , A^-Z, a-z). If the pass- 
word is null, the encrypted password is also null. Password 
aging is effected for a particular user if the encrypted 
password in the password file is followed by a comma and a 
non-null string of characters from the above alphabet. Such 
a string must be introduced in the first instance by the 

superuser . 

The first character of the password age, e.g., M, denotes 

the maximum number of weeks for which a password is valid, 
A user who attempts to login after the password has expired 
will be forced to supply a new one. The next character, 
e.g,, m, denotes the minimum period (in weeks) which must 
expire before the password may be changed. The remaining 
characters define the week (counted from the beginning of 
1970 ) when the password was last changed, A null string is 
equivalent to zero. M and m have numerical values in the 

range O -63 that correspond to the 64-character alphabet 
shown above (i.e,, / = 1 week; z = 63 weeks). If m = M = 0 
(derived from the string , or ,,) the password must be 
changed the next time the user logs in (and the ''age’’ will 
disappear from the user's entry in the password file). If m 
> (signified, e.g,, by the string ,/), only the superuser 
will be able to change the password. 
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FILES 

/etc/ pass wH 

SEE ALSO 

login(l), passwd(l), a641(3G), crypt(3C), 
group ( 4 ) . 


g e t pwen t ( 3 C ) , 
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NAME 

plot -graphics interface 
DESCRIPTION 

Files of this format are produced by routines described in 
plot ( 3X ) and are interpreted for various devices by commands, 
described in t plot ( 1 G ) . A graphics file is a stream of 
plotting instructions. Each instruction consists of an 
ASCII letter usually followed by bytes of binary informa- 
tion. The instructions are executed in order. A point is 
designated by 4 bytes representing the x and y values; each 
value is a signed integer. The last designated point in an 
1, m, n, or p instruction becomes the ''current point'' for 
the next instruction. 

Each of the following descriptions begins with the name of 
the corresponding routine in plot ( 3X) . 

D move; The next 4 bytes give a new current point. 

n cont: Draw a line from the current point to the point 
given by the next 4 bytes. See t plo t ( 1 G ) . 

p point: Plot the point given by the next 4 bytes. 

1 line: Draw a line from the point given by the next 4 
bytes to the point given by the following 4 bytes. 

‘t label: Place the following ASCII string so that its 

first character falls on the current point. The string 
is terminated by a new-line, 

e erase: Start another frame of output. 

f linemod: Take the following string, up to a new-line, as 
the style for drawing further lines. The styles are 
''dotted'', ''solid'', ''longdashed'', ''shortdashed'', 
and '' dotd ashed '' . This instruction is effective only 
for the -T4014 and ^Tver options of t pi o t ( 1 G ) (Tektronix 
4014 terminal and Versatec plotter), 

3 space; The next 4 bytes give the lower left corner of 
the plotting area; the following 4 give the upper right 
corner. The plot will be magnified or reduced to fit the 
device as closely as possible. 

Space settings that exactly fill the plotting area with 
unity scaling appear below for devices supported by the 
filters of t pi o t ( 1 G ) . The upper limit is just outside the 
plotting area. In every case the plotting area is taken to 
be square; points outside may be displayable on devices 
whose face is not square. 
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DAST 

300 

space( 0 , 

0, 

4096 , 

4096 ) ; 

DASI 

300 s 

space ( 0 , 

0, 

4096 , 

4096 ) ; 

DASI 

450 

s pac e ( 0 , 

0. 

4096 , 

4096 ) ; 

Tektronix 4014 

space( 0 , 

0, 

3120 , 

3120) ; 

Versatec plotter 

space( 0 , 

0, 

2048, 

2048) ; 


SEE ALSO 

graph (1G), tplot(IG), plot(3X), gps(4), terin(5). 
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NAME 

pnch ^ file format for card images 

DESCRIPTION 

The PNCH format is a convenient representation for files 
consisting of card images in an arbitrary code. 

A PNCH file is a simple concatenation of card records, A 
card record consists of a single control byte followed by a 
variable number of data bytes. The control byte specifies 
the number (which must lie in the range O-r-SO) of data bytes 
that follow. The data bytes are S^'bit codes that constitute 
the card image. If there are fewer than 80 data bytes, it 
is understood that the remainder of the card image consists 
of trailing bl anks . 

SEE ALSO 

send ( 1 C ) . 
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NAME 

profile - setting up an environment at login time 


DESCRIPTION 

If a user's login d ir ec to r y con t a in s a file named .profile, 
that file will be executed (via the shell's exec .profile) 
before the user's session begins; .profiles are handy for 
setting exported environment variables and terminal modes. 
If the file /etc/profile exists, it will be executed for 
every user before the .profile. The following example is 
typical (except for the comments); 


// Make some environment variables global 
export MAIL PATH TERM 
// Setfilecreationmask 
umask 22 

// Tell me when new mail comes in 
MAIL=/usr/mail/myname 

// Add my /bin directory to the shell search sequence 

PATH=$ PATH :$HOME/ bin 

# Set terminal type 

echo "terminal; \c" 

read TERM 

case$TERMin 


300 ) 

st t y 

cr2 

nlO 

tabs; 

tabs; 

300 s) 

St t y 

cr 2 

nlO 

tabs; 

tabs; 

450) 

St t y 

cr2 

nlO 

tabs; 

tabs; 

hp) 

St t y 

c r 0 

nlO 

tabs; 

tabs; 

7451735) 

st t y 

cr 1 

nl 1 

-•tabs ; 

TERM 

43) 

St ty 

cr 1 

nlO 

-tabs ; 

• 

• 

40141 tek) 

st ty 

cr 0 

nlO 

-tabs 

ff 1 ; 

») 

echo 

"$TERM 

un known 

tt . . 
t * 


e sac 


FILES 


$HOME/ . pro f i 1 e 
/etc/ profile 


SEE ALSO 

env(1), login(1), raail(l), sh(1), stty(1), su(1), 
environ(5), term(5). 
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NAME 

reloc - relocation information for a common object file 
SYNOPSIS 

linclude <reloc.h> 

DESCRIPTION 

Object files have one relocation entry for each relocatable 
reference in the text or data. If relocation information is 
present, it will be in the following format, 

struct reloc 

{ 

long 
long 
short 

} ; 

/* 

* All generics 

* reloc. already performed to svmbol in the same section 

»/ 

y/d e f i n e R_A B S 0 

/» 

* DEC Processors VAX 11/780 and VAX 11/750 

« 

*/ 

y/define R_RELBYTE 017 
y/define R_RELWORD 020 
//define R_RELL0NG 021 
//define R_PCRBYTE 022 
//define R_PCRW0RD 023 
//define R_PCRL0NG 02 4 

/» 

» Motorola 68000 uses R_RELBYTE, R__RELW0RD, R_RELL0NG, 

* R^PCRBYTE, and R__PCRW0RD as for DEC machines above, 

»/ 


As the link editor reads each input section and performs 
relocation, the relocation entries are read. They direct how 
references found within the input section are treated, 

R__ABS The reference is absolute, and no relocation 

is necessary. The entry will be ignored, 

R_^RELBYTE A direct 8-bit reference to a symbol’s vir^ 

tual address, 

R__^RELW0RD A direct 16-bit reference to a symbol's vir- 

tual address , 


r__vaddr ; /* (virtual) address of reference */ 

r_symndx ; /* index into symbol table */ 

r__type ; /* relocation type */ 
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R RELLONG 


A direct 32-^bit reference to a symbol’s vir' 
tual address. 


R_PCRBYTE 

A ' ' PC-r el ati ve ’ ’ S'-bit 
symbol's virtual address. 

reference 

to 

a 

R_PCPWORD 

A ' ' PC-r el a ti ve ’ ' l6-bit 

symbol’s virtual address. 

r e f er enc e 

to 

a 

R_PCRLONG 

A ' ' PC-r el a t i V e ' ' B^^-bit 

symbol’s virtual address. 

r e f er enc e 

to 

a 

On the VAX 
ind ic ate s 
segment ’ s 

processors, relocation of a symbol index of -1 
that the relative difference between the current 
start address and the program’s load address is 


added to the relocatable address. 


Other relocation types will be defined as they are needed. 

Relocation entries are generated automatically by the assem- 
bler and automatically utilized by the link editor, A link 
editor option exists for removing the relocation entries 
from an object file. 

SEE ALSO 

Id ( 1 ) , strip(l), a.out(4), syms(4). 
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NAME 

scnhdr section header for a common object file 
SYNOPSIS 

#include <scnhdr.h> 

DESCRIPTION 

Every common object file has a table of section headers to 
specify the layout of the data within the file. Each sec-r- 
tion within an object file has its own header. The C strucr- 
ture appears below. 


struct 

{ 

scnhd r 





char 


s name [ S YM NMLE N ] 

; /* section name */ 


long 


s^padd r ; 

/« 

physical address */ 


long 


s__vadd r ; 

/* 

virtual address */ 


long 


s_ s i z e ; 

/* 

section size * / 


long 


s^scnptr ; 

/* 

file ptr to raw data */ 


long 


s___r el pt r ; 

/» 

file ptr to relocation * 


long 


s_^lnno ptr ; 

/» 

file ptr to line numbers 


unsigned 

short 

s__nr el oc ; 

/» 

# reloc entries */ 


unsigned 

short 

s_nl nno ; 

/* 

f/ line number entries */ 

} ; 

long 


s__f 1 ag s ; 

/* 

flags * / 


File pointers are byte offsets into the file; they can be 
used as the offset in a call to f seek ( 3S ) . If a section is 
initialized, the file contains the actual bytes. An unini- 
tialized section is somewhat different. It has a size, sym- 
bols defined in it, and symbols that refer to it, but it can 
have no relocation entries, line numbers, or data. Conse- 
quently, an uninitialized section has no raw data in the 
object file, and the values for s sc npt r , s r el pt r , 
s Inno pt r , s nr el oc , and s nl nno are zero. 

SEE ALSO 

ld(l), fseek(3S), a.out(4). 
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MAME 

syras - common object file symbol table format 

SYNOPSIS 

finclude <syms.h> 

DESCRIPTION 

Common object files contain information to support symbol i c 
software testing (see sd b ( 1 ) . Line number entries, 1 ine^ 
num ( 4 ) , and extensive symbolic information permit testing at 
the C source level. Every object file’s symbol table is 
organized as shown below. 

Filename 1 , 

Func t ion 1 , 

Local symbols for function 1, 

Function ? 

Local symbols for function 2, 

• • • 

Static externs for file 1. 

Fi 1 en ame 2 . 

Function 1 , 

Local symbols for function 1. 

Function 2. 

Local symbols for function 2, 

• • • 

Static externs for file 2, 


Defined global symbols. 

Undefined global symbols. 

The entry for a symbol is a fixed^length structure. The 
members of the structure hold the name (null padded) , its 
value, and other information. The C structure is given 
below. 

//define SYMNMLEN 8 
//define FILNMLEN 14 

struct syment 

{ 

union 

I 

char 
struct 
{ 

long 
long 
} n_n ; 
char 

} ^n; 

long 


-1- Print ed6l985 


/* ways to get a symbol name*/ 

__n__name[ SYMNMLEN] ;/* names less than 8 chars. */ 
/* names 8 char or more*/ 

_n__zeroes; /* == OL when in string table*/ 
__n__offset; /* location of name in table */ 

*__^n__npt r [ 2 ] ; /* allows overlaying */ 

n value ; /* value of symbol */ 
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} ; 

#define 

//define 

//define 

//define 


short 

unsigned 

char 

char 


n_^scnum ; 
sho r t 

n_^sclass ; 
n numaux ; 


J* section number */ 

n_^type ; /* type and derived type 

/* storage class */ 

/* number of aux entries */ 


n__^nam e 
n_^zer o e s 
n_of f se t 
n npt r 


n .__^n__nam e 
n .___n_n ‘..n^^^zer o e s 
n ._n_n ._n_of f se t 
n . n nptr C 1 ] 


Meaningful values and explanations for them are given in 
both syms.h and Common Object File Format . Anyone who needs 
to interpret the entries should seek more information in 
these sources. Some symbols require more information than a 
single entry; they are followed by au xil i ary entries that 
are the same size as a symbol entry. The format follows. 


un ion 

{ 


aux en t 


struct, 

{ 


long x_tagnd x ; 

union 

{ 

struct 

{ 

unsigned short x__lnno ; 
unsigned short x__si ze ; 

} x__ 1 n s z ; 

long x_f s i ze ; 

} x_^mi sc ; 
un ion 
{ 

struct 

{ 

long x_lnno ptr ; 
long x^end nd x ; 

} x__fcn; 

struct 

{ 


unsigned short x_d im en [ DT M NUM ] ; 
} x_ary; 

} x_^fcnary; 

unsigned short x_tvndx; 

} x^^syra; 

struct 

{ 

char x_fn ame[ F ILNMLE N ] ; 

} x_ f i 1 e ; 

struct 

{ 


long x_sc nl en ; 
unsigned short x__nreloc; 
unsigned short x nlinno; 
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} x_scn; 

struct 

{ 


} 

}; 

Indexes of symbol table entries begin at zer o , 

SEE ALSO 

sdb(1), a.out(4), linenum(4). 

Common Object F_i ^ e Format by I . S , Law. 

WARNING 

In machines in which longs are equivalent to ints (M68000 
and VAX), the longs are converted to ints in the compiler to 
minimize the complexity of the compiler code generator. 
Thus, the information about which symbols are declared as 
longs and which as ints cannot be determined from the symbol 
table. 


unsigned short x_tvlen; 
unsigned short x__tvran[2]; 
X tv ; 
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NAME 

utmp, wtmp - utmp and wtmp entry formats 
SYNOPSIS 

linclude < sys/ t ype s ,h> 
i^include <utmp,h> 

DESCRIPTION 

These files hold user and accounting information for com- 
mands such as who ( 1 ) , wr i t e ( 1 ) , and log in ( 1 ) . They have the 
following structure, as defined by <utinp.h>: 

//define UTMP_FILE "/etc/utmp" 

//define WTMP_FILE "/etc/wtmp" 

//define ut name ut user 


struct utmp { 


char 

ut_user [ 8 ] ; 

/* 

User login name */ 

char 

ut_id [ 4 ] ; 

/» 

/etc/inittab id (usually lin 

char 

ut__line[12]; 

/* 

device name (console, Inxx) 

short 

ut__pi d ; 

/» 

process id */ 

short 

ut__type ; 

/* 

type of entry */ 

struct 

exit_status { 



short 

extermination; 

/* 

Process termination status * 

short 

e exit; 

/» 

Process exit status */ 

} ut__exit 

f 

/* 

The exit status of a process 



* 

marked as DE A D^P P OC ESS . */ 

time t 

}; 

ut^time ; 

/* 

time entry was made */ 

/* Definitions 

for ut type */ 



//define EMPTY 

0 



//define PUN LVL 

1 




//define BOOT_TIME 2 

//define OLD_TTME 3 

//define NEW_TIME 4 

//define IN TT__PROC ESS 5 /* Process spawned by "init” */ 

//define LOGTN_PROCESS 6 /•A "getty" process waiting for loj 

//define USER__PROCESS 7 /* A user process */ 

//define DEAD_PROCESS 8 
//define ACCOUNTING 9 

//define UTMAXTYPE ACCOUNTING /* Largest legal value of ut__^type 

/• Special strings or formats used in the "ut^line" field when */ 
/* accounting for something other than a process. ♦/ 

/* No string for the ut_^line field can be more than 11 chars + */ 

/* a NULL in length, */ 

//define RUNLVL_MSG "run-level 5&c" 

//define BOOT_^MSG "system boot" 

//define OTIME__MSG "old time" 

//define NTIME_^MSG "new time" 

FILES 

/usr/include/utmp.h 
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/etc /utmp 
/etc/wtmp 

SEE ALSO 

login(l), who(1), write(l), getut(3C). 
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NAME 

intro - in tro<i uc t ion to miscellaneous facilities 


DESCRIPTION 

This section liescribes facilities such as formatting 
mentation and setting the terminal environment. It 
contains descriptions of various character set tables, 
values, and user-accessible data types. 


d oc u- 
al so 
flag 


- 1 - 


Printed 6 1985 


ASGII(5) 


ASCII(5) 


NAME 

ascii -r- map of ASCII character set 
SYNOPSIS 

cat / usr / pub/ asc i i 
DESCRIPTION 

Ascii is a map of the ASCII character set, giving both octal 
and hexadecimal equivalents of each character, to be printed 
as needed. It contains: 


000 

nul 

1 001 

soh 

1 002 

St X 

1003 

e tx 

1 004 

eo t 

1 005 

enq 

1 006 

ac k 

1007 

bel 

010 

bs 

1011 

ht 

1012 

nl 

1013 

vt 

1014 

np 

1015 

cr 

1016 

so 

1017 

si 

020 

die 

1 021 

del 

I022 

dc2 

1023 

dc3 

1024 

dc4 

1025 

nak 

1026 

syn 

1027 

etb 

030 

can 

1031 

em 

I032 

sub 

1033 

esc 

1034 

fs 

1035 

gs 

1036 

r s 

1037 

us 

040 

sp 

1 041 

1 

I 042 


1043 


1044 

$ 

1045 

% 

1046 

& 

1047 

1 

050 

( 

i051 

) 

1052 

» 

1053 

+ 

1054 

9 

1055 


1056 

• 

1057 

/ 

060 

0 

!061 

1 

I 062 

2 

1063 

3 

1064 

4 

1065 

5 

1066 

6 

1067 

7 

070 

8 

1071 

9 

1072 

• 

• 

1073 

f 

1074 

< 

1075 

r 

1076 

> 

1077 

? 

1 00 

@ 

1101 

A 

1 102 

B 

1 103 

C 

1 1 04 

D 

1105 

E 

1 106 

F 

1107 

G 

110 

H 

1111 

I 

1112 

J 

1113 

K 

1114 

L 

1115 

M 

1116 

N 

1117 

0 

120 

P 

1 121 

Q 

1 122 

R 

1 123 

S 

1 124 

T 

1 125 

U 

1126 

V 

1127 

W 

1 30 

X 

1131 

Y 

1132 

Z 

1133 

C 

1134 

\ 

1 135 

] 

1136 


1137 


1 40 

X 

1141 

a 

1 1 42 

b 

1 143 

e 

1144 

d 

1 1 45 

e 

1 146 

f 

1 147 

g 

150 

h 

1151 

i 

1 152 

j 

1 153 

k 

1 154 

1 

1 155 

m 

1 156 

n 

i 157 

0 

160 

P 

1 161 

q 

1 1 62 

r 

1 163 

s 

1 164 

t 

1 165 

u 

1 166 

V 

1 167 

w 

170 

X 

1171 

y 

1 172 

z 

1173 

{ 

1174 

1 

1 

1175 

} 

1 176 


1177 

del 


00 

nul 

1 01 

soh 

1 02 

St X 

1 

1 

03 

e tx 

04 

eo t 

1 05 

enq 

1 06 

ac k 

1 07 

bel 

08 

bs 

1 09 

ht 

1 Oa 

nl 

1 

1 

Ob 

vt 

Oc 

np 

1 Od 

cr 

1 Oe 

so 

1 Of 

si 

10 

die 

1 1 1 

del 

1 12 

dc2 

1 

1 

13 

dc3 

14 

dc4 

1 15 

nak 

1 16 

syn 

1 17 

etb 

18 

can 

1 19 

em 

1 la 

sub 

1 

1 

1b 

esc 

1 c 

fs 

1 Id 

gs 

1 1e 

r s 

1 If 

us 

20 

sp 

1 21 

! 

1 22 

tt 

1 

1 

23 

# 

24 

$ 

1 25 

% 

1 26 

& 

1 27 

t 

28 

( 

1 29 

) 

1 2a 

« 

1 

1 

2b 

+ 

2c 

9 

1 2d 


1 2e 

• 

1 2f 

/ 

30 

0 

1 31 

1 

1 32 

2 

1 

1 

33 

3 

34 

4 

1 35 

5 

1 36 

6 

1 37 

7 

38 

8 

1 39 

9 

1 3a 

: 

1 

1 

3b 

9 

3c 

< 

1 3d 

= 

1 3e 

> 

1 3f 

7 

40 

@ 

1 41 

A 

1 42 

B 

1 

1 

43 

C 

44 

D 

1 45 

E 

1 46 

F 

1 47 

G 

48 

H 

1 49 

I 

1 4a 

J 

1 

1 

4b 

K 

4c 

L 

i 4d 

M 

1 4e 

N 

1 4f 

0 

50 

P 

1 51 

Q 

1 52 

R 

1 

1 

53 

S 

54 

T 

1 55 

U 

1 56 

V 

1 57 

W 

58 

X 

1 59 

Y 

1 5a 

Z 

1 

1 

5b 

[ 

5c 

\ 

1 5d 

] 

1 5e 

A 

1 5f 


60 


1 61 

a 

1 62 

b 

1 

1 

63 

c 

64 

d 

1 65 

e 

1 66 

f 

1 67 

g 

68 

h 

1 69 

i 

1 6a 

j 

1 

1 

6b 

k 

6 c 

1 

1 6d 

m 

1 6e 

n 

1 6f 

0 

70 

P 

1 71 

q 

1 72 

r 

1 

1 

73 

s 

74 

t 

1 75 

u 

1 76 

V 

1 77 

w 

78 

X 

1 79 

y 

1 7 a 

z 

1 

7b 

{ 

1 7c 

1 

1 

1 7d 

} 

1 7e 


1 7f 

del 


FILES 

/usr/ pub/ascii 
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NAME 

environ -user environment 
DESCRIPTION 

An array of strings called the ''environment’’ is made 
available by ex ec ( 2 ) when a process begins. By convention, 
these strings have the form nam e = v al ue . The following names 
are used by various commands: 

PATH The sequence of directory prefixes that commands such 
a s _sh ( 1 ) , ( 1 ) ♦ nice ( 1 ) , and no hup ( 1 ) apply in 

searching for a file known by an incomplete pathname. 
The prefixes are separated by colons (;). Log in C 1 ) 
sets PATH= :/bin :/u3r/bin , 

HOME Name of the user’s login directory, set by 1 og in ( 1 ) 
from the password file pa sswd ( 4 ) . 

TERM The kind of terminal for which output is to be 
prepared. This information is used by commands such as 
mm(1), _v_i( 1 ) , and t plot ( 1 G ) , which may exploit special 
capabilitiesoftheterminal. 

TZ Time zone information. The format is xxxnzzz where xxx 
is the standard local time zone abbreviation, n is the 
difference in hours from GMT, and zzz is the abbrevia- 
tion for the d ayl i ght-^sa V ing local time zone, if any; 
for example, EST5EDT. 

Further names may be placed in the environment by the export 
command and n am e = v al ue arguments in ^(1)f or by exec (2 ) . 
It is unwise to conflict with certain shell variables that 
are frequently exported by .profile files, e.g., MAIL, PS1, 
PS2, IFS. 

SEE ALSO 

env(1), login(l), sh(1), exec(2), getenv(3C), profile(4), 
term ( 5 ) . 
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NAME 

fcntl - file control options 


SYNOPSIS 

linclude <fcntl.h> 


DESCRIPTION 

The f cnt 1 ( 2 ) function provides for control over open files. 
This # include file describes requests and arguments to 
f c nt 1 ( 2 ) and open ( 2 ) . 


/* Flag values accessible to open(2) and fcntl(2) */ 


/» (The 


first three can 

only be 

set by open) */ 



f/ d e f i n e 

0 

__RDONLY 

0 






//define 

o' 

“WPONLY 

1 






//define 

o' 

"rdwr 

2 






//define 

o' 

"ndelay 

04 

/» 

Non- 

blocking I/O */ 



//define 

o' 

__APPEND 

010 

/» 

append (writes guaranteed at 

t he 

end ) 

/» Flag 

values accessible 

only to open(2) */ 



//define 

0 

GREAT 

00400 

/♦ 

open 

with file create (uses 

third 

open 

//define 

o' 

“trunc 

01 000 

/» 

open 

with truncation */ 



//define 

o' 

'"excl 

02000 

/* 

exclusive open */ 




/* fcntl(2) requests */ 
//define F_DUPFD 0 
//define F_GETFD 1 
//define F_SETFD 2 
//define F_GETFL 3 
//define F SETFL 4 


/* Duplicate fildes */ 
/* Get fildes flags */ 
/♦ Set fildes flags */ 
/* Get file flags */ 

/* Set file flags */ 


SEE ALSO 

fcntl ( 2 ) , open( 2 ) . 
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NAME 

greek *- graphics for the extended TTY-37 type-box 

SYNOPSIS 

cat / usr/ pub/ greek [ ! greek -Tterminal ] 

DESCRIPTION 

Greek gives the mapping from ASCII to the ''shift-out’’ 
graphics in effect between SO and SI on TELETYPE ( Reg . ) Model 
37 terminals equipped with a 128-character type-box. These 
are the default greek characters produced by nro f f . The 
filters of gr eek ( 1 ) attempt to print them on various other 
terminals. The file contains: 


al pha 

A 

A 

beta 

B 

B 

gamma 

\ 

\ 

GAMMA 

G 

G 

delta 

D 

D 

DELTA 

W 

W 

epsilon 

S 

S 

ze t a 

Q 

Q 

eta 

N 

N 

THETA 

0 

T 

theta 

T 

0 

lambda 

L 

L 

LAMBDA 

E 

E 

mu 

M 

M 

nu 

§ 

@ 

X i 

X 

X 


J 

J 

PI 

P 

P 

r ho 

K 

K 

sigma 

Y 

Y 

SIGMA 

R 

R 

t a u 

T 

I 

phi 

U 

U 

PHI 

F 

F 

ps i 

V 

V 

PSI 

H 

H 

om eg a 

C 

C 

OMEGA 
par ti al 

Z 

] 

Z 

] 

n ab 1 a 
integral 

[ 

[ 

no t 

— 

— 


FILES 

/usr /pub/greek 
SEE ALSO 

300( 1 ), M012|(1), 450(1), greek(l), hp(1), tc(1), nroff(l). 


- 1 


Printed 6 1985 



MAN(5) 


MAH(5) 


NAME 

man - macros for formatting entries in this manual 

SYNOPSIS 

nroff -man files 
troff -man [ -rsl ] files 
DESCRIPTION 

These tr o f f ( 1 ) macros are used to lay out the format of the 
entries of this manual, A skeleton entry may be found in 
the file /usr/man/u_^man/manO/skeleton . These macros are 
used by the m an ( 1 ) command. 


The default page size is 8,5"x11", with a 6,5"x10" text 
area; the -rsl option reduces these dimensions to 6"x9" and 
4. 75 "x8, 375", respectively; this option, which is not effec- 
tive in nr o f f ( 1 ) , also reduces the default type size from 
10-point to 9-point and the vertical line spacing from 12- 
point to 10-point, The -rV2 option may be used to set cer- 
tain parameters to values appropriate for certain Versatec 
printers: it sets the line length to 82 characters and the 
page length to 84 lines, and it inhibits underlining; this 
option should not be confused with the -Tvp option of the 
m an ( 1 ) command, which is available at some UNIX System 
sites.. 

Any text argument below may be one to six ''words’’. Double 
quotes ("") must be used to include blanks in a ''word’’. 
If text is empty, the special treatment is applied to the 
next line that contains text to be printed. For example, ,I 
may be used to italicize a whole line, or ,SM followed by ,B 
to make small bold text. By default, hyphenation is turned 
off for nroff but remains on for troff . 

Type font and size are reset to default values before each 
paragraph and after processing font-setting and size-setting 
macros, e,g., . 1 , , RB , .SM. Tab stops are neither used nor 
set by any macro except ,DT and ,TH. 

Default units for indents ( in.) are ens. When a macro is 
given without the Jjn argument, the previous indent is used. 
The "remembered" indent is set to its default value by the 
. TH , , P , . SH , and .SS macros. This value is 7.2 ens in troff 
and 5 ens in nroff ; both are equal to 0.5 inches in the 
default page size. This means that within each subheading 
section (SYNOPSIS, DESCRIPTION, etc.) the default left mar- 
gin is 0,5 inches to the right of the page offset (i.e,, 
normal left margin) of the page. If the entire page width 
is needed (e.g., to format a large table), use ,ln alone on 
a line to override the default indented margin. 
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Each macro description below includes the effect on indenta- 
tion, as applicable. 


. TH ^ _s c n 

,SH text 

, SS text 

• ® text 

• ^ text 
.SM text 

.RI a b 

.P 

.HP in 


.TP in 


.IP t in 
.PS in 


Set the title and entry heading; t is the 
title, £ is the section number, c is extra com- 
mentary, e.g,, ''local*', n is new manual name. 
Invokes ,DT (see below). 

Place subhead tex t, e.g,, SYNOPSIS, here. The 
text lines that follow the heading are block- 
style paragraphs; the whole block is indented 
0,5 inches. 

Place sub-subhead text , e.g.. Options, here. 
The text lines that follow the heading are 
block-style paragraphs; the whole block is 
indented 0.5 inches. 

Make text bold. 

Make tex t italic. 

Make text 1 point smaller than default point 
size. 

Concatenate roman a with italic b, and alter- 
nate these two fonts for up to six arguments, 
vSimilar macros alternate between any two of 
roman, italic, and bold: 

,IR .RB ,BR .IB .BI 
Skip one vertical space and begin a paragraph 
with normal font, point size, and indent (0.5 
inches). .PP has the same effect as ,P, 

Skip one vertical space and begin a paragraph 
with a hang ing ind en t , The first line of the 
paragraph will be indented the default 0,5 
inches from the page offset. The other lines 
will be indented the additional number of ens 
specified by in , 

Skip one vertical space and begin indented 
paragraph with hanging tag. The next line that 
contains text to be printed is taken as the 
tag. The indentation from the beginning of the 
tag to the beginning of the paragraph is speci- 
fied by the argument. If the tag does not 
fit, it is printed on a separate line. Format 
within the paragraph can be controlled by using 
the nr o f f commands ,br and ,nf (refer to the 
Doc urn en t Processing Guide ) . 

Same as .TP ^ with tag t; often used to get an 
indented paragraph without a tag. 

Increase indentation relative to the current 
margin. If given without an argument, the text 
following the macro will be indented 0.5 
inches. The ,RS macro does not cause a verti- 
cal space to be inserted before the following 
output. Use ,sp on the line before the ,RS 
line to obtain this space. If an in argument 
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.RE k 


.PM m 


. DT 
.PD V 


is given, the .RS macro will indent the follow- 
ing output ^ units from the current left mar- 
g in . 

Return to the kth relative indent level (ini- 
tially, j<= 1 ; k = 0 is equivalent to _k= 1 ) ; if J< is 
omitted, return to the most recent lower indent 
level, .RS/.RE pairs can be nested. 

Produces proprietary markings; where m may be p 
for PRIVATE, H for' NOTICE, BP for BELL LABORA- 
TORIES PROPRIETARY, or BR for BELL LABORATORIES 
RESTRICTED. 

Restore default tab settings (every 7.2 ens in 
tr 0 f f . 5 ens in nroff ) . 

Set the interpar agr aph distance to _v vertical 
spaces. Tf _v is omitted, set the interpara- 
graph distance to the default value (0.4v in 
troff , 1v in nroff) . 


The following strings are defined; 

\*R ''(Reg,)’’ in nr o f f ( 1 ) , ''Registered’’ symbol 

in tr 0 f f ( 1 ) , 

\*S Change to default type size, 

\*(Tm Trademark indicator. 

The following number registers are given default values by 
.TH: 

IN Left margin indent relative to subheads 

(default is 7.2 ens in troff, 5 ens in n roff ) . 
LL Line length including IN , 

PD Current inter par agr aph distance. 

WARNINGS 

In addition to the macros, strings, and number registers 
mentioned above, there are defined a number of internal mac- 
ros, strings, and number registers. Except for names prede- 
fined by troff and number registers d, m, and y, all such 
internal names are of the form JLA, where X is one of ), ], 

and }, and A stands for any alphanumeric character. 

If a manual entry needs to be preprocessed by £w(1), eqn ( 1 ) 
(or neqn ) , and/or tb 1 ( 1 ) , it must begin with a special line 
(described in m an ( 1 ) ) , causing the man command to invoke the 
appropriate pr e pr oc es sor ( s ) . 

The programs that prepare the Table of Contents and the Per- 
muted Index for the User’s Manual and Administrator’s Manual 
assume the NAME section of each entry consists of a single 
line of input that has the following format: 

name[, name, name ...] \- explanatory text 
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To eliminate ambiguity, the macro package increases the 
inter-word spaces in the SYNO PS IS section of each entry. 

The macro package itself uses only the roman font (so that 
one can replace, for example, the bold font by the 
constant-width font-see £w( 1 ) ) . Of course, if the input 
text of an entry contains requests for other fonts (e.g,, 
,1, .RB, \fl), the corresponding fonts must be mounted. If 
a single word or short phrase needs to be italicized or 
emboldened, the following usage can be placed within a line, 
rather than creating a separate ,B or .1 line: \fItext\fR. 

Nr 0 f f and tr o f f formatting commands and macros are described 
in the Document Processing Guide, 


FILES 

/usr/lib/tmac/tmac .an 
/usr /lib/macros/ cm p,[nt] ,[dt] ,an 
/usr / lib/macros/ ucmp.Cnt] .an 
/ usr /man/ [ ua ] man '' m anO / skel e ton 


SEE ALSO 

man(1), nroff(l), troff(l). 


BUGS 

When using the macros to alternate fonts (e.g., ,RB, .IR), 
quotation marks must be used to maintain spacing. For exam- 
ple, ,IR filename produces filename as one word. . IR "file 
" name produces it as two words. 
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NAME 

mm - the MM macro package for formatting documents 
SYNOPSIS 

mm [ options ] [ files ] 

nroff -mm C options ] [ files ] 

nroff -cm [ options ] C files ] 

mmt [ options ] [ files ] 

troff -mm [ options ] [ files ] 

troff -cm [ options ] [ files ] 


DESCRIPTION 

This package provides a formatting capability for a wide 
variety of documents. The manner in which a document is 
typed and edited is essentially independent of whether the 
document is to be eventually formatted at a terminal or pho- 
totypeset. See the references below for further details. 

The -mm option causes nro f f ( 1 ) and tro f f ( 1 ) to use the non- 
compacted version of the macro package, while the *.cm option 
results in the use of the compacted version, thus speeding 
up the process of loading the macro package. 


FILES 

/usr/lib/tmac/tmac.m 


/usr/lib/macros/mm[nt] 
/usr/lib/macros/cmp.[nt] .[dt] .m 
/usr/lib/macros/ucmp.[nt] ,m 


pointer to the non- 
compacted version of the 
package 

non-compac ted version of 
the package 

compacted version of the 
package 

initializers for the com- 
pacted version of the 
package 


SEE ALSO 

mm(1), ramt(l), nroff(l), troff(l). 

Doc umen t Processing Guide . 

MM - Memor and urn Macros by D. W. Smith and J. R. Mashey. 

Typing Doc urn en t s with MM by D. W. Smith and E. M. Piskorik. 
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NAME 

mosd -r. the OSDD adapter macro package for formatting docu^ 
men t s 

SYNOPSIS 

osdd [ options ] [ files ] 

mm -mosd [ options ] [ files ] 

nroff -mm -mosd [ options ] [ files ] 

nroff -cm ^mosd [ options ] [ files ] 

mmt -mosd [ options ] [ files ] 

troff -mm ^mosd [ options 3 [ files ] 

troff -cm ^mosd [ options ] [ files ] 

DESCFIPTION 

The OSDD adapter macro package is a tool used in conjunction 
with the nirnCl) macro package to prepare Operations Systems 
Deliverable Documentation. Many of the OSDD Standards are 
different than the default format provided by ^(1). The 
OSDD adapter package sets the appro pr ia te mm ( 1 ) options for 
automatic production of the OSDD Standards. The OSDD 
adapter package also generates the correct OSDD page headers 
and footers, heading styles, Table of Contents format, etc. 

OSDD document (input) files are prepared with the mm(1) mac-r- 
ros. Additional information which must be given at the 
beginning of the document file is specified by the following 
stringdefinitions: 

.ds HI doc urn en t--number 
.ds H? section-number 
.ds H3 issue-number 
.ds H4 date 
.ds H5 rating 

The document - number should be of the standard 10-character 
format. The words ''Section*' and ''Issue'' should not be 
included in the string definitions; they will be supplied 
automatically when the document is printed. For example, 

.ds H1 OPA-1 P 1 35'-01 
.ds H2 4 
.ds H3 2 

automatically produces 
OPA-1 P 1 35'-0 1 
Section 4 
Issue 2 

as the document page header. Quotation marks are not used 
in string definitions. 
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If certain information is not to be included in a page 
header, the string is defined as null; e.g., 

.ds HP 

means that there is no sec tion -^ number . 

The OSDD Standards require that the Table o f Contents be 
numbered beginning with Page J[, By default, the first page 
Of text will be numbered Page 2. If the Tab 1 e o f Contents 
has more than one page, for example n, either «*rPn+2 must be 
included as a command line option or ,nr P n must be 

included in the document file. For example, if the Table o f 

Contents is four pages, use «-rP5 on the command line or 
.nr P 4 in the document file. 

The OSDD Standards require that certain information such as 
the document rating appear on the Doc urn en t Index or on the 
Table o f Contents page if there is no index. By default, it 

is assumed that an index has been prepared separately. If 

there is no index, the following must be included in the 
d oc urn en t file: 

.nr Di 0 

This will ensure that the necessary information is included 
° ^ t ® Table o _f Con ten ts page. 

The OSDD Standards require that all numbered figures be 
placed at the end of the document. The ,Fg macro is used to 
produce full page figures. This macro produces a blank page 
with the appropriate header, footer, and figure caption. 
Insertion of the actual figure on the page is a manual 
operation. The macro usage is 

.Fg page--count "figure caption" 
where page- count is the number of pages required for a 
multi-page figure (default 1 page). 

Figure captions are produced by the .Fg macro using the 
.BS/.BE macros; therefore, the .BS/.BE macros are not avail- 
able for users. The .Fg macro cannot be used within the 
document unless the final .Fg in a series of figures is fol- 
lowed by a .SK macro to force out the last figure page. 

Table o f Contents for OSDD documents (see Figure 4 in 
Section 4.1 of the OSDD Standards) is produced with: 

.Tc 

System Type 
System Name 
Document Type 
. Td " 

The ,Tc/.Td macros are used instead of the .TC macro from 
mm ( 1 ) . 

By default, the adapter package causes the NOTICE disclosure 
statement to be printed. The .PM macro may be used to 
suppress the NOTICE or to replace it with the PRIVATE dis- 
closure statement as follows: 
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.PM none printed 

.PM P PRIVATE printed 

.PM N NOTICE printed (default) 

The ,P macro is used for paragraphs. The Np register is set 
automatically to indicate the paragraph numbering style. It 
is very important that the ,P macro be used correctly. All 
paragraphs (including those immediately following a .H 
macro) must use a .P macro. Unless there is a ,P macro, 
there will not be a number generated for the paragraph. 
Similarly, the ,P macro should not be used for text which is 
not a paragraph. The ,SP macro may be appropriate for these 
cases, e.g., for ''paragraphs’* within a list item. 

The page header format is produced automatically in accor^ 
dance with the OSDD Standards. The OSDD Adapter macro pack-^ 
age uses the .TP macro for this purpose. Therefore the .TP 
macro normally available in r^(1) is not available for 
users. 


FILES 

/usr/lib/tmac/tmac .osd 


SEE ALSO 

mm(1), mmt(1), nroff(l), troff(l), mm(5). 

MM ^ Memor and urn Macros by D. W. Smith and J. R. Mashey. 
Operations Systems Deliverable Documentation Standards, June 
1 980 . 
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NAME 

mptx - the macro package for formatting a permuted index 
SYNOPSIS 

nroff ^-mptx [ options ] [ files ] 
troff T-mptx [ options ] [ files ] 

DESCRIPTION 

This package provides a definition for the ,xx macro used 
for formatting a permuted index as produced by p t x ( 1 ) . This 
package does not provide any other formatting capabilities 
such as headers and footers. If these or other capabilities 
are required, the mptx macro package may be used in conjunc-^- 
tion with the mmC 1 ) macro package. In this case, the -mptx 
option must be invoked after the -mm call. For example; 

nroff -cm -mptx file 
or 

mm -mptx f i 1 e 

FILES 

/usr/ lib/ traac/ traac , pt X pointer to the no n-com pa c ted ver- 
sion of the package 

/ usr / 1 i b /macro s/ pt X no n-cora pa c t ed version of the pack- 

age 

SEE ALSO 

mm(1), nroff(l), ptx(l), troff(l), mm(5). 
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NAME 

mv - a troff macro package for typesetting viewgraphs and 
slides 

SYNOPSIS 

mvt [ -a ] [ options ] C files ] 

troff [ -a ] [ ~rX1 ] -mv [ options ] [ files ] 

DESCRIPTION 

This package makes it easy to typeset viewgraphs and projec- 
tion slides in a variety of sizes. A few macros (briefly 
described below) accomplish most of the formatting tasks 
needed in making transparencies. All the facilities of 
t r 0 f f ( 1 ) , £w( 1 ) t gqn ( 1 ) , and tb 1 ( 1 ) are available for more 
difficulttasks. 

The output can be previewed on most terminals (in particu- 
lar, the Tektronix 4014) and on the Versatec printer. For 
these two devices, specify the -rXI option (this option is 
automatically specified by the mvt command when that command 
is invoked with the -14014 or -Tvp options; see mm t ( 1 ) ) . To 
preview output on other terminals, specify the -a option. 

The available macros are: 

• VS Cn] [_i] [d^] Foil-start macro; foil size is to be 

7'’x7*'; _n is the foil number, ^ is the 
foil identification, _d is the date; the 
foil-start macro resets all parameters 
(e.g,, indent, point size) to initial 
default values, except for the values 
of _i and ^ arguments inherited from a 
previous foil-start macro; it also 
invokes the ,A macro (see below). 

The naming convention for this and the 
following 8 macros is that the first 
character of the name (V or S) distin- 
guishes between viewgraphs and slides, 
while the second character indicates 
whether the foil is square (S), small 
wide (w), small high (h), big wide (W), 
or big high (H), Slides are narrower 
than the corresponding viewgraphs; the 
ratio of the longer dimension to the 
shorter one is larger for slides than 
for viewgraphs. As a result, slide 
foils can be used for viewgraphs, but 
not vice versa; on the other hand, 
viewgraphs can accommodate a bit more 
text. 
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Vw 

[n] 

[i] 

[d] 

Vh 

[n] 


[d] 

VW 

[n] 


[d] 

VH 

Cn] 


[d] 

Sw 

[ n] 


[d] 

Sh 

[n] 

[i] 

[d] 

SW 

Cn] 

[i] 

[d] 

SH 

[n] 


[d] 

A 

[x] 




B [m [s] ] 


C [m [_s] ] 

D Cm [£] ] 

T s t r ing 
I [ in ] [a C X ] ] 


S [p] [1] 


Same 

as .VS, 

except 

7 ' ’ wide X 5 

’ ' high 

Same 

as .VS, 

except 

5 ' ’x7 

1 1 

• 


Same 

as .VS, 

except 

7 ’ ’ x5 

.4” . 


Same 

as . VS , 

except 

7 ’ ' x9 

t t 

• 


Same 

as .VS, 

except 

7 ” x5 

t t 

0 


Same 

as . VS , 

except 

5’ ’x7 

t t 

• 


Same 

as , VS , 

except 

7”x5 

.4” . 


Same 

as .VS, 

except 


that 

foil 

size 

i s 

that 

foil 

size 

i s 

that 

foil 

size 

i s 

that 

foil 

size 

i s 

that 

foil 

size 

i s 

that 

foil 

size 

i s 

that 

foil 

size 

is 

that 

foil 

size 

i s 


7 ’ ’ x9 ’ ’ . 

Place text that follows at the first 
indentation level (left margin); the 
presence of x suppresses the 1/2 line 
spacing from the preceding text. 

Place text that follows at the second 
indentation level; text is preceded by 
a mark; m is the mark (default is a 
large bullet); s is the increment or 
decrement to the point size of the mark 
with respect to the prevailin g point 
size (default is 0); if £ is 100, it 
causes the point size of the mark to be 
the same as that of the d e f a ul t mark. 
Same as ,B, but for the third indenta- 
tion level; default mark is a dash. 

Same as .B, but for the fourth indenta- 
tion level; default mark is a small 
bullet. 

S tring is printed as an over-size, cen- 
tered title. 

Change the current text indent (does 
not affect titles); _iji is the indent 
(in inches unless dimensioned, default 
is 0); if i_n is signed, it is an incre- 
ment or decrement; the presence of a^ 
invokes the ,A macro (see below) and 
passes £ (if any) to it. 

Set the point size and line length; £ 
is the point size (default is ''previ- 
ous’’); if p is 100, the point size 
reverts to the initial default for the 
current foil-start macro; if £ is 
signed, it is an increment or decrement 
(default is 18 for ,VS, .VH, and .SH, 
and 14 for the other foil-start mac- 
ros); 1 is the line length (in inches 
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.DF n f [n f . . . ] 


•DV [a] [b] [c] [d] 




unless dimensioned; default is 4.2’’ 
for .Vh, 3.8’’ for .Sh, 5’’ for .SH, 
and 6’’ for the other foil-start mac- 
ros) . 

Define font positions; may not appear 
within a foil’s input text (i.e,, it 
may only appear after all the input 
text for a foil, but before the next 
foil-start macro); n is the position of 
font £; up to 4 "^'n _f ’ ’ pairs may be 
specified; the first font named becomes 
the prevail ing font; the initial set- 
ting Ts nr~ i s a synonym for G): 

,DF1H2T3B4S 
Alter the vertical spacing between 
indentation levels; a is the spacing 
for ,A, b is for ,B, £ is for ,C, and £ 
is for ,D; all non-null arguments must 
be dimensioned; null arguments leave 
the corresponding spacing unaffected; 
initial setting is : 

,DV ,5v ,5v ,5v Ov 

Underline st r 1 and concatenate s tr 2 ( i f 

any) to it. 


The last 4 macros in the above list do not cause a break; 
the ,I macro causes a break only if it is invoked with more 
than one argument; all the other macros cause a break. 


The macro package also recognizes the following up per- case 
synonyms for the corresponding lower-case tr o f f requests: 

.AD .BP .CE .FI .HY . NA . NF . NH .NX .SO .SP 
.TA .TT 

The Tm string produces the trademark symbol. 


The input tilde (~) character is translated into a blank on 
output , 

See the references cited below for further details. 


FILES 

/usr/lib/tmac/tmac . v 
/usr/ lib/macros/ vmca 

SEE ALSO 

cw(1), eqn(1), mmt(1), tbl(1), troff(l). 

Doc urn en t Processin g Gu ide . 

A Pac kage fo r Vie w Gr aphs and Slides by T, A, Dolotta 

and D, W. Smith. 


BUGS 
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The ,VW anh .SW foils are meant to be 9*' wiHe by 7'' 
but because the typesetter paper is generally only 8’ 
they are printed 7’* wide by 5.4’’ high and have 
enlarged by a factor of 9/7 before use as viewgraph 
makes them less useful. 


high , 
’ wide, 
to be 
s ; this 
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NAME 

regexp ~ regular expression compile and match routines 
SYNOPSIS 

fdefine INIT <deolar ations> 

Idefine GETCC) <getc code> 

^define PEEKCC) <peekc code> 

#define UNGETC(c) <ungetc code> 

#define RETURN ( po in ter ) <return code> 

Idefine ERROR(val) <error code> 

linclude <regexp.h> 

char *compi le( in str ing , expbuf, endbuf, eof) 
char *instring, *expbuf, *endbuf 

int stepCstring, expbuf) 
char ^string, *expbuf; 

DESCRIPTION 

This page describes general purpose regular expression 
matching routines in the form of _e_d ( 1 ) , defined in 
/usr/include/regexp.h . Programs such as ££1^ I ) » sed ( 1 ) , 
gr e p( 1 ) » ^ ^ ex pr ( 1 ) » which perform regular expres- 

sion matching, use this source file. Therefore, only the 
regexp file need be changed to maintain regular expression 
compa t ib i 1 i ty , 


The interface to this file is unpleasantly complex. Pro- 
grams that include this file must have the following 5 mac- 
ros declared before the linclude <regexp,h> statement. 
These macros are used by the com pi 1 e routine , 


GETCC ) 


PEEKCC ) 


UNGETCC c) 


Return the value of the next character 
in the regular expression pattern. Suc- 
cessive calls to GETCC) should return 
successive characters of the regular 
expression. 

Return the next character in the regular 
expression. Successive calls to PEEKCC) 
should return the same character C which 
should also be the next character 
returned by GETCC)), 

Cause the argument _c to be returned by 
the next call to GETCC) Cand PEEKCC)). 
No more that one character of pushback 
is ever needed and this character is 
guaranteed to be the last character read 
by GETCC), The value of the macro 
UNGETCCc) is always ignored. 
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RETURN ( pointer ) This macro is used on normal exit of the 

compile routine. The value of the argu- 
ment point er is a pointer to the charac- 
ter after the last character of the com- 
piled regular expression. This is use- 
ful to programs which have memory allo- 
cation to manage. 

This is the abnormal return from the 
compile routine. The argument v al is an 
error number (see table below for mean- 
ings), This call should never return, 

MEANING 

Range endpoint too large. 

Bad number, 

''\digit’' out of range. 

Illegal or missing delimiter. 

No remembered search string, 

\( \) imbalance. 

Too many \ ( , 

More than 2 numbers given in \{ \}, 

} expected after \, 

First number exceeds second in \{ \}, 

[ ] imbalance. 

Regular expression overflow. 

The syntax of the compile routine is as follows: 


compi 1 e ( in St r ing , expbuf, endbuf, eof) 

The first parameter instring is never used explicitly by the 
compi 1 e routine but is useful for programs that pass down 
different pointers to input characters. It is sometimes 
used in the. INIT declaration (see below). Programs which 
call functions to input characters or have characters in an 
external array can pass down a value of ((char •) 0) for 
this par ameter , 

The parameter expbuf is a character pointer. It points to 
the place where the compiled regular expression will be 
placed. 

The parameter endbu f is one more than the highest address 
where the compiled regular expression may be placed. If the 
compiled expression cannot fit in ( end buf - ex pbuf ) bytes, a 
call to ERROR(50) is made. 

The parameter eo f is the character that marks the end of the 
regular expression. For example, in _^(1)f this character 
isusuallya/. 


ERROR (val) 


ERROR 
1 1 
16 
25 
36 

41 

42 

43 

44 

45 

46 

49 

50 
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Each program that includes this file must have a fdefine 
statement for INTT. This definition will be placed right 
after the declaration for the function c om p i 1 e and the open- 
ing curly brace ({). Tt is used for dependent declarations 
and initializations. Most often it is used to set a regis- 
ter variable to point the beginning of the regular expres- 
sion so that this register variable can be used in the 
declarations for GETC(), PEEKCC) and UNGETCC), Otherwise it 
can be used to declare external variables that might be used 
by GETCO, PEEKCO and UNGETCO. See the example below of 
the declarations taken from gr ep ( 1 ) . 

There are other functions in this file which perform actual 
regular expression matching, one of which is the function 
step . The call to step is as follows: 

stepCstring, expbuf) 

The first parameter to step is a pointer to a string of 
characters to be checked for a match. This string should be 
null terminated. 

The second parameter expbuf is the compiled regular expres- 
sion which was obtained by a call of the function compile . 

The function ste p returns one, if the given string matches 
the regular expression, and zero, if the expressions do not 
match. Tf there is a match, two external character pointers 
are set as a side effect to the call to step . The variable 
set in step is loci . This is a pointer to the first charac- 
ter that matched the regular expression. The variable 1 oc2 , 
which is set by the function advance , points to the charac- 
ter after the last character that matches the regular 
expression. Thus, if the regular expression matches the 
entire line, loci will point to the first character of 
string and loc2 will point to the null at the end of string . 

Step uses the external variable c ir c f which is set by com- 
pile if the regular expression begins with . If this is 
set, step will only try to match the regular expression to 
the beginning of the string. If more than one regular 
expression is to be compiled before the first is executed 
the value of c i r c f should be saved for each compiled expres- 
sion and c i r c f should be set to that saved value before each 
call to step . 

The function advance is called from step with the same argu- 
ments as step . The purpose of step is to step through the 
string argument and call advance ; ste p continues until 
advance returns a one indicating a match or until the end of 
strin g is reached. If one wants to constrain string to the 
beginning of the line in all cases, step need not be called; 
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simply call a<i v anc e . 

When advance encounters a • or \{ \} sequence in the regular 
expression, it will advance its pointer to the string to be 
matched as far as possible and will recursively call itself 
trying to match the rest of the string to the rest of the 
regular expression. As long as there is no match, ad v anc e 
will back up along the string until it finds a match or 
reaches the point in the string that initially matched the * 
or \{ \}. It is sometimes desirable to stop this backing up 
before the initial point in t,he string is reached. If the 
external character pointer Iocs is equal to the point in the 
string at sometime during the backing up process, advance 
will break out of the loop that backs up and will return 
zero. This is used by £^(1) and sed ( 1 ) for substitutions 
done globally (not just the first occurrence, but the whole 
line); for example, ex pr e ssi on s 1 i ke s/y*//g do not loop 
forever . 

The routines ecmp and getr ange are trivial and are called by 
the routines previously mentioned. 


EXAMPLES 

The following is an example of how the regular expression 
macros and calls look from grep( 1 ) ; 


//define INIT register char *sp 
//define GETCO (»sp + +) 
j/define PEEKCO (»sp) 

//define UNGETC(c) ( — sp) 
//define RETURN(c) return; 
//define ERROR(c) regerrC) 


in s t r ing ; 


//include <regexp,h> 


compi 1 e( *ar g V , expbuf, & ex pb uf [ ES IZ E ] , ' \0 ’ ) ; 


i f ( step( linebuf , expbuf)) 
succ eed ( ) ; 


FILES 

/usr/includ e/regexp. h 
SEE ALSO 

ed(1), grepCi), sed(1). 


BUGS 

The routine ecmp is equivalent to the Standard I/O routine 
St r ncmp and should be replaced by that routine. 
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NAME 

term conventional names for terminals 


DESCRIPTION 

The names in this file are used by certain commands (e.g,, 
nro f f , mni(1), m an ( 1 ) , tab s ( 1 ) ) and are maintained as part of 
the shell environment (see ^(1), profile (4) , and 
env iron( 5 ) ) in the variable $TERM; 


1520 
1 55 
1 620 
1 620-12 
165 
2621 
2631 
2631 -c 
2631 -e 
2640 
2645 
300 

300-1 2 
300 s 
382 

300S-1 2 
3045 
33 
37 

40-2 

40-4 

4540 

3270 

4000a 

401 4 

43 

450 

450-1 2 
735 
745 
dumb 


s ync 


hp 

Ip 

tn 1200 
tn300 
tv i950 


Datamedia 1520 
Motorola EXORterm 155 

Diablo 1620 and others using the HyType II printer 

same, in 12-pitch mode 

Motorola EXOFset 165 

Hewlett-Packard HP2621 series 

Hewlett-Packard 2631 line printer 

Hewlett-Packard 2631 line printer - compressed mode 
Hewlett-Packard 2631 line printer - expanded mode 
Hewlett-Packard HP2640 series 

Hewlett-Packard HP264n series (other than the 2640 series) 
DASI/DTG/GSI 300 and others using the HyType I printer 
same, in 12-pitch mode 
DASI/DTC/GSI 300s 
DTC 382 

same, in 12-pitch mode 
Datamedia 3045 

TELETYPE(Reg . ) Terminal Model 33 KSR 

TELETYPE Terminal Model 37 KSR 

TELETYPE Terminal Model 40/2 

TELETYPE Terminal Model 40/4 

TELETYPE Terminal Model 4540 

IBM Model 3270 

Trendata 4000a 

Tektronix 4014 

TELETYPE Model 43 KSR 

DASI 450 (same as Diablo 1620) 

same, in 12-pitch mode 

Texas Instruments TI735 and TI725 

Texas Instruments TI745 

generic name for terminals that lack reverse 
line-feed and other special escape sequences 
generic name for synchronous TELETYPE 
4540-compatible terminals 
Hewlett-Packard (same as 2645) 
generic name for a line printer 
General Electric TermiNet 1200 
General Electric TermiNet 300 
TeleVideo 950 


Local changes to this list are common. Refer to 
/ete/terfflesp for information on terminals supported for your 
system . 
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Up to 8 characters, chosen from [ *- a-^z 0-9 ] » make up a basic 
terminal name. Terminal sub-models and operational modes 
are distinguished by suffixes beginning with a Names 
should be based on original vendors, rather than local dis- 
tributors. A terminal acquired from one vendor should not 
have more than one distinct basic name. 

Commands whose behavior depends on the type of terminal 
should accept arguments of the form -T term ^wher e term is one 
of the names given above; if no such argument is present, 
such command s should obtain the terminal type from the 
environment variable $TERM, which, in turn, should contain 
_^r_m . 

SEE ALSO 

m[n(1), nroff(l), tplot(IG), sh(1), stty(l), tabs(1), pro- 
file(4), environ(5). 


BUGS 

Programs that should make use of this file do not adhere to 
the nomenclature in a consistent manner. 
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NAME 

stat - data returned by stat system call 

SYNOPSIS 

linclude < sys/ type s .h> 

^include <sy3/stat.h> 


DESCRIPTION 

The system calls stat and f st a t return data whose structure 
is defined by this include file. The encoding of the field 
st mode is defined in this file also. 


* Structure of the result of stat 

»/ 


struct stat 

{ 

d ev_^ t 
ino_t 
u s h 0 r t 
short 
ushor t 
u s h o r t 
dev t 
off“t 
t i me__t 
time_t 
t i m e__ t 

}; 


st_d e V ; 
st__ino ; 
st_mod e ; 
st__nl ink ; 
st_ui d ; 
st^gid ; 
st__rd ev ; 
st^si ze ; 
st__atime ; 
st^mtlme ; 
st ctime ; 


//define 

S 

IFMT 

01 70000 

/» 

type of file */ 


//define 

s 

IFDTR 

0040000 

/» 

directory */ 


if define 

S_ 

IFCHR 

0020000 

/» 

character special */ 


//define 

s 

IFBLK 

0060000 

/» 

block special * / 


//define 

s" 

IFREG 

01 00000 

/» 

regular*/ 


//define 

s"“ 

IFIFO 

001 0000 

/* 

fifo */ 


#def ine 

S 

ISUTD 

04000 

/* 

set user id on execution */ 


//define 

s”" 

ISGTD 

02000 

/* 

set group id on execution */ 


//define 

s”" 

ISVTX 

01 000 

/» 

save swapped text even after use 

*/ 

//define 

s 

IREAD 

00400 

/« 

read permission, owner */ 


//define 

s' 

TWRITE 

00200 

/» 

write permission, owner */ 


//define 

s' 

lEXEG 

001 00 

/* 

ex ecute/ se ar ch permission, owner 

»/ 


FILES 

/usr/include/sys/types ,h 
/usr/include/sys/stat.h 


SEE ALSO 

st a t ( 2 ) , type s( 5 ) . 
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NAME 


types primitive system data types 

SYNOPSIS 

linclude < sys/ type s .h> 


DESCRIPTION 

The data types defined in the include file are used in 
tern 
code: 


syS' 


code; ; 

some data 

of 

these types are 

t yped ef 

struct { 

in t 

r [ 1 ] ; } * ph ys 

t y ped ef 

long 


d add r__t ; 

t yped ef 

char * 


c a d d r__ t ; 

typed ef 

un si gned 

in t 

u i n t ; 

t y ped e f 

un si gned 

short ushort; 

t yped ef 

u s h 0 r t 


i n o__ t ; 

t yped ef 

short 


c n t t ; 

t y ped e f 

long 


time t ; 

t yped ef 

i n t 


label__t[10]; 

t yped ef 

short 


dev t ; 

t yped ef 

long 


of f_t ; 

t yped e f 

long 


pad d r_t ; 

typed ef 

long 


key t ; 


The form daddr t is used for disk addresses except in an 
inode on disk; see il3(4). Times are encoded in seconds 
since 00:00:00 GMT, January 1, 1970. The major and minor 
parts of a device code specify kind and unit number of a 
device and are in st a 1 1 a t i on^d epend en t , Offsets are measured 
in bytes from the beginning of a file. The label t vari-^ 
ables are used to save the processor state while another 
processisrunning. 


SEE ALSO 

fs(4) . 
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NAME 

termcap - terminal capability data base 

SYNOPSIS 

/etc/ termcap 

DESCRIPTION 

Termcap is a data base which describes terminals. Each 
entry in the file gives a set of capabilities for a terminal 
and describes how operations are performed. Padding 
requirements and initialization sequences are included in 
termcap . The data base is used by programs such as v i ( 1 ) . 

Entries in termcap consist of a number of separated 

fields. The first entry for each terminal gives the names 
which are known for the terminal, separated by charac- 

ters. The first name is always 2 characters long and is 
used by older systems which store the terminal type in a 
16-bit word in a systemwide data base. The second name is 
the most common abbreviation for the terminal and the last 
name should be a long name fully identifying the terminal. 
The second name should contain no blanks; the last name may 
well contain blanks for readability. 

Preparing Descriptions 

The most effective way to prepare a terminal description is 
to imitate the description of a similar terminal in termcap 
and build up a description gradually, using partial descrip- 
tions with £_x to check that they are correct. Be aware that 
a very unusual terminal may expose d e f i c i enc i e s in the abil- 
ity of the termcap file to describe it or bugs in _ejc , To 
easily test a new terminal description, set the environment 
variable TERMCAP to a pathname of a file containing the 
description being worked on; the editor will look there 
rather than in / etc/ termcap , TERMCAP can also be set to the 
term cap entry itself to avoid reading the file when starting 
up the editor. 

Similar Terminals 

If there are two very similar terminals, one can be defined 
as being just like the other with certain exceptions. The 
string capability tc can be given with the name of the simi- 
lar terminal. This capability must be last and the combined 
length of the two entries must not exceed 1024. Since term- 
li b routines search the entry from left to right, and since 
the tc capability is replaced by the corresponding entry, 
the capabilities given at the left override the ones in the 
similar terminal. A capability can be cancelled with xx€ 
where xx is the capability. For example, the entry 
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hni 26?lnl :ks§ :ke§ :tc = 2621 : 

defines a 2621nl that does not have the ks or ke capabili- 
ties, and hence does not turn on the function key labels 
when in visual mode. This is useful for different modes for 
a terminal, or for different user preferences. 

CAPABILITIES 

Capabilities in termcap are of three types; Boolean capabil- 
ities, which indicate that the terminal has some particular 
feature; numeric capabilities, which give the size of the 
terminal or the size of particular delays; and string capa- 
bilities, which give a sequence that can be used to perform 
particular terminal operations. 

Entries may be continued onto multiple lines by giving a \ 
as the last character of a line. Empty fields may be 
included for readability (e.g., between the last field on a 
line and the first field on the next). 

List of Capabilities 

(P) indicates padding may be specified 


(P») 

indicates that padding may be based on no. lines affected 

Name 

Type 

Pad? 

Description 



ae 

str 

(P) 

End alternate character set 



a 1 

st r 

(P») 

Add new blank line 



am 

bool 


Terminal has automatic margins 



a s 

str 

(P) 

Start alternate character set 



be 

str 


Backspace character, if not “'H 



bs 

bool 


Terminal can backspace with 



b t 

str 

(P) 

Back tab 



b w 

bool 


Backspace wraps from column 0 to last 

column 

CC 

str 


Command character in prototype 

if terminal settab 

cd 

str 

(P«) 

Clear to end of display 



c e 

str 

(P) 

Clear to end of line 



c h 

str 

(P) 

Like cm but horizontal motion only, line stays sar 

cl 

str 

(P») 

Clear screen 



cm 

str 

(P) 

Cursor motion 



CO 

num 


Number of columns in a line 



cr 

str 

(P») 

Carriage return, (default ''M) 



cs 

str 

(P) 

Change scrolling region (vtIQO) 

, like 

cm 

cv 

str 

(P) 

Like ch but vertical only. 



d a 

bool 


Display may be retained above 



dB 

num 


Number of millisec of bs delay 

needed 


db 

bool 


Display may be retained below 



dC 

num 


Number of millisec of cr delay 

needed 


d c 

str 

(P») 

Delete character 



dF 

num 


Number of millisec of ff delay 

needed 


^1 

str 

(P») 

Delete line 



dm 

str 


Delete mode (enter) 
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Number of millisec of nl delay needed 
Down one line 

Number of millisec of tab delay needed 
End delete mode 

End insert mode; give :ei=; if ic 
Can erase overstrikes with a blank 
Hardcopy terminal page eject (default ''L) 

Hardcopy terminal 

Half-line down (forward 1/2 linefeed) 

Home cursor (if no cm) 

Half-line up (reverse 1/2 linefeed) 

Hazeltine; can’t print ~’s 

Insert character 

Name of file containing is 

Insert mode (enter); give ;im=: if ic 

Insert mode distinguishes nulls on display 

Insert pad after character inserted 

Terminal in i t i al i za t i on st r i ng 

Sent by other function keys 0-9 

Sent by backspace key 

Sent by terminal down arrow key 

Out of keypad transmit mode 

Sent by home key 

Sent by terminal left arrow key 
Number of other keys 

Termcap entries for other non-function keys 

Sent by terminal right arrow key 

Put terminal in keypad transmit mode 

Sent by terminal up arrow key 

Labels on other function keys 

Number of lines on screen or page 

Last line, first column (if no cm) 

Arrow key map, used by vi version 2 only 
Safe to move while in insert mode 
Memory lock on above cursor. 

Safe to move while in standout and underline mode 
Memory unlock (turn off memory lock). 

No correctly working carriage return ( DM2500 , H200‘ 
Non-destructive space (cursor right) 

Newline character (default \n) 

Terminal is a CRT but doesn’t scroll. 

Terminal overstrikes 

Pad character (rather than null) 

Has hardware tabs (may need to be set with is) 

End stand out mode 
Scroll forwards 

Number of blank chars left by so or se 
Begin stand out mode 
Scroll reverse (backwards) 

Tab (other than '"I or with padding) 

Entry of similar terminal - must be last 
String to end programs that use cm 
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t i 

str 

uc 

str 

ue 

str 

ug 

num 

ul 

bool 

up 

str 

us 

str 

vb 

str 

ve 

str 

V s 

str 

X b 

bool 

xn 

bool 

xr 

bool 

x s 

bool 

xt 

bool 


String to begin programs that use cm 
Underscore one char and move past it 
End underscore mode 

Number of blank chars left by us or ue 

Terminal underlines even though it doesn’t overst 

Upline (cursor up) 

Start underscore mode 

Visible bell (may not move cursor) 

Sequence to end open/visual mode 
Sequence to start open/visual mode 
Beehive (f1=escape, f2=ctrl C) 

A newline is ignored after a wrap (Concept) 

Return acts like ce \r \n (Delta Data) 

Standout not erased by writing over it (HP 264?) 
Tabs are destructive, magic so char (Teleray lOb"! 


A Sample Entry 

The following entry, which describes the Cone ept - 1 00 , is 
among the more complex entries in the termcap file as of 
this writing, (This particular concept entry is outdated, 
and is used as an example only.) 

c11c100looncept100;is=\EU\Ef\E7\£5\E8\El\ENH\EK\E\200\Eo&\200;\ 

:al = 3*\E''P:am:bs:cd=16*\E''C:ce=l6\E''S:cl = 2*''L:cm=\Ea^+ %+ 'c 
:dc=i6\E"A:dl = 3«\E''B:ei = \E\200:eo:im=\E''P:in:ip=l6»;li#2‘ i 
:se=\Ed\Ee:so=\ED\EE:ta=8\t:ul:up=\E;:vb=\Ek\EK;xn: 

Capability Descriptions 

All capabilities have 2-letter codes. For instance, the 
fact that the Concept-lOO has automatic margins (i.e,, an 
automatic return and linefeed when the end of a line is 
reached) is indicated by the capability am in the sample 
description above. Numeric capabilities are followed by the 
character ' // ’ and then the value. Thus, co, which indicates 
the number of columns the terminal has, gives the value '80* 
for the Concept-100. 

Str ing- val ued capabilities, such as ce (clear to end of line 
sequence), are given by the 2-character code, an '=’, and a 
string ending at the next field separator (:). A delay in 
milliseconds may appear after the '=’ in such a capability 
and padding characters are supplied by the editor after the 
remainder of the string is sent to provide this delay. The 
delay can be either an integer, e,g,, '20*, or an integer 
followed by an i.e,, '3*’. An indicates that the 
padding required is proportional to the number of lines 
affected by the operation, and the amount given is the per- 
a f f ec ted -un i t padding required. When an is specified, 
it is sometimes useful to give a delay of the form '3.5’ to 
specify a delay per unit to tenths of milliseconds. 
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A number of escape sequences are provided in the string- 
valued capabilities for easy encoding of characters there. 
A \E maps to an ESCAPE character, ''x maps to a control-x for 
any appropriate x, and the sequences \n \r \t \b \f give a 
newline, return, tab, backspace and formfeed. Finally, 
characters may be given as 3 octal digits after a \, and the 
characters and \ may be given as and \\ , Tf it is 

necessary to place a colon (;) in a capability, it must be 
escaped in octal as \072, If it is necessary to place a 
null character in a string capability, it must be encoded as 
\200. The routines which deal with termcap use C strings, 
and strip the high bits of the output very late; therefore, 
a \200 comes out as a \000 would. 

Basic capabilities 

The number of columns on each line for the terminal is given 
by the co numeric capability. If the terminal is a CRT, 
then the number of lines on the screen is given by the li 
capability. If the terminal wraps around to the beginning 
of the next line when it reaches the right margin, its 

description should include the am capability. If the termi- 
nal can clear its screen, this is given by the cl string 
capability. If the terminal can backspace, it should have 
the bs capability, unless a backspace is accomplished by a 
character other than '‘H, in which case the alternate charac- 
ter should be given as the be string capability. If it 
overstrikes (rather than clearing a position when a charac- 
ter is struck over), it should have the os capability, 

A very important point is that the local cursor motions 
encoded in termcap are undefined at the left and top edges 
of a CRT terminal. The editor will never attempt to back- 
space around the left edge, nor will it attempt to go up 
locally off the top, the editor assumes that feeding off 

the bottom of the screen will cause the screen to scroll up, 

and the am capability tells whether the cursor sticks at the 

right edge of the screen. If the terminal has switch- 
selectable automatic margins, the termcap file usually 
assumes that this is on, i.e., am. 

These capabilities suffice to describe hardcopy and glass- 
tty terminals. Thus, the model 33 teletype is described as 

t3i33! tty33:co//72:os 

while the Lear Siegler ADM-3 is described as 

cl{ adm3l3l Isi adm3:am:bs:cl = ^Z:li#24:coy/80 

Cursor addressing 


5 


Printed 6 1985 



TERMCAPCS) 


TERMCAP(5) 


Cursor ad dressing in the terminal is described by the cm 
string capability. It uses escapes like those in 
pr in t f ( 3s ) , i.e., Jx. These substitute to encodings of the 
current line or column position, while other characters are 
passed through unchanged. If the cm string is thought of as 
being a function, then its arguments are the line and column 
to which motion is desired. The ) encodings have the fol- 
lowing meanings: 


%d as in pr in t f , 0 origin 
%2 like %2d 

%3 like %3d 

like %Q 

%+x adds X to value, then %, 

%>xy if value > x adds y, no output. 

%r reverses order of line and column, no output 
/6i increments line/column (for 1 origin) 

%% gives a single % 

%Vi exclusive or row and column with 0140 (DM2500 ) 

%B BCD (I6*(x/10)) + (x%10), no output. 

56D Reverse coding ( x-2* ( X/5 1 6 ) ) , no output. (Delta Data) 

For example, to get to row 3 and column 12 the HP2645 needs 
to be sent \E&a12c03Y padded for 6 milliseconds. Note that 
the order of the rows and columns is inverted here, and that 
the row and column are printed as 2 digits-. Thus, its cm 
capability is cm = 6 \E&/6 r%2c%2Y , The Microterm ACT-IV needs 
the current row and column sent, preceded by a ^T, with the 
row and column simply encoded in binary, cm=''T/6.%.. Termi- 
nals which use %, need to be able to backspace the cursor 
(bs or be) , and to move the cursor up one line on the screen 
(up is introduced below). This is necessary because it is 
not always safe to transmit \t, \n ''D and \r , because the 
system may change or discard them. 

A final example is the LSI ADM-3a , which uses row and column 
offset by a blank character; thus, cm=\E=%+ %+ . 

Cursor motions 

If the terminal can move the cursor one position to the 
right, leaving the character at the current position 
unchanged, this sequence should be given as nd (non- 
destructive space). If it can move the cursor up a line on 
the screen in the same column, this should be given as up. 

If the terminal has no cursor addressing capability, but can 
home the cursor (to the very upper left corner of screen), 
this can be given as ho; similarly, a fast way of getting to 
the lower left hand corner can be given as 11; this may 
involve moving up with up from the home position, but the 
editor will never do this itself (unless 11 does) because it 
makes no assumption about the effect of moving up from the 
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home position. 

Area clears 

If the terminal can clear from the current position to the 
end of the line, leaving thecursor where it is, this should 
be given as ce. If the terminal can clear from the current 
position to the end of the display, then this should be 
given as cd . The editor only uses od from the first column 
o f a 1 i n e . 

Insert/ del ete line 

If the terminal can open a new blank line before the line 
where the cursor is, this should be given as al; this is 

done only from the first position of a line. The cursor 

must then appear on the newly blank line. If the terminal 
can delete the line which the cursor is on, this should be 
given as dl; this is done only from the first position on 

the line to be deleted. If the terminal can scroll the 

screen backwards, this can be given as sb , although just al 
suffices. If the terminal can retain display memory above, 
the da capability should be given; if display memory can be 
retained below, db should be given. These capabilities let 
the editor understand that deleting a line on the screen may 
bring non-blank lines up from below or that scrolling back 
with sb may bring down non-blank lines. 

Insert/delete character 

Ter me ap can be used to describe two basic kinds of intelli- 
gent terminals with respect to insert/delete characters. 
The most common in ser t/ d el e t e character operations affect 
only the characters on the current line and shift characters 
off the end of the line rigidly. Other terminals, such as 
the Concept 100 and the Perkin Elmer Owl, make a distinction 
between typed and untyped blanks on the screen, shifting 
upon an insert or delete only to an untyped blank on the 

screen; the blank is either eliminated or expanded to 2 

untyped blanks. You can find out which kind of terminal you 

have by clearing the screen and then typing text separated 

by cursor motions. Type abc def using local cursor 
motions (not spaces) between the abc and the def. Then 
position the cursor before the abc and put the terminal in 
insert mode. If typing characters causes the rest of the 
line to shift rigidly and characters to fall off the end, 
then your terminal does not distinguish between blanks and 
untyped positions. If the abc shifts over to the def which 
then move together around the end of the current line and 
onto the next as you insert, you have the second type of 
terminal, and should give the capability in, which stands 
for insert null. If your terminal does something different 
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and unusual then you may have to modify the editor to get it 
to use the insert mode your terminal defines. We have seen 
no terminals with an insert mode that does not fall into one 
of these two classes. 

The editor can handle both terminals which have an insert 
mode, and terminals which send a simple sequence to open a 
blank position on the current line, (Insert mode is prefer- 
able to the sequence to open a position on the screen if 
your terminal has both,) To specify im, give the sequence to 
get into insert mode or give an empty value if your terminal 
uses a sequence to insert a blank position. Give as ei the 
sequence to leave insert mode If you gave im with an empty 
value, give ei with an empty value also. Now give as ic any 
sequence needed to be sent just before sending the character 
to be inserted. Most terminals with a true insert mode will 
not give ic; terminals which send a sequence to open a 
screen position should give it here. If post-insert padding 
is needed, give this as a number of milliseconds in ip (a 
string option). Any other sequence which may need to be 
sent after an insert of a single character may also be given 
in ip. 

It is occasionally necessary to move around while in insert 
mode to delete characters on the same line (e.g., if there 
is a tab after the insertion position). If your terminal 
allows motion while in insert mode you can give the capabil- 
ity mi to speed up inserting in this case. Omitting mi will 
affect only speed. Some terminals (notably Datamedia’s) 
must not have mi because of the way their insert mode works. 

Finally, you can specify delete mode by giving dm and ed to 
enter and exit delete mode; give dc to delete a single char- 
acter while in delete mode. 

Highlighting, underlining, and visible bells 

If your terminal has sequences to enter and exit standout 
mode these can be given as so and se respectively. If there 
are several flavors of standout mode (such as inverse video, 
blinking, or underlining - half bright is not usually an 
acceptable standout mode unless the terminal is in inverse 
video mode constantly) the preferred mode is inverse video 
by itself. If the code to change into or out of standout 
mode leaves 1 or even 2 blank spaces on the screen, as the 
TVI 912 and Teleray 1061 do, then ug should be given to tell 
how many spaces are left. 

Codes to begin underlining and end underlining can be given 
as us and ue , respectively. If the terminal has a code to 
underline the current character and move the cursor one 
space to the right, such as the Microterm Mime, this can be 
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given as uc . If the underline code does not move the cursor 
to the right, give the code followed by a nondestructive 
space . 

Many terminals, such as the HP 2621, automatically leave 
standout mode when they move to a new line or the cursor is 
addressed. Programs using standout mode should exit stan- 
dout mode before moving the cursor or sending a newline. 

If the terminal has a way of flashing the screen to indicate 
an error quietly (a bell replacement), this can be given as 
vb; it must not move the cursor. If the terminal should be 
placed in a different mode during open and visual modes of 
ex , this can be given as vs and ve, sent at the start and 
end of these modes, respectively. These can be used to 
change, e.g., from an underline to a block cursor and back. 

If the terminal needs to be in a special mode when running a 
program that addresses the cursor, the codes to enter and 
exit this mode can be given as ti and te , This need arises, 
for example, from terminals like the Concept-100 with more 
than one page of memory. If the terminal has only memory- 
relative cursor addressing and not screen relative cursor 
addressing, a 1-screen sized window must be fixed into the 
terminal for cursor addressing to work properly. 

If the terminal correctly generates underlined characters 
(with no special codes needed), even though it does not 
overstrike, you should give the capability ul . If over- 
strikes are erasable with a blank, this should be indicated 
by giving eo . 

Keypad 

If the terminal has a keypad that transmits codes when the 
keys are pressed, this information can be given. Note that 
it is not possible to handle terminals where the keypad only 
works in local (this applies, for example, to the unshifted 
HP 2621 keys). If the keypad can be set to transmit or not 
transmit, give these codes as ks and ke ; otherwise, the 
keypad is assumed to always transmit. The codes sent by the 
left arrow, right arrow, up arrow, down arrow, and home keys 
can be given as kl , kr , ku , kd , and Uh , respectively. If 
there are function keys such as fO, f1, .... f 9 ♦ the codes 
they send can be given as kO, kl, •••, k9. Tf these keys 
have labels other than the default fO through f 9 , the labels 
can be given as 10, 11, •••, 19. If there are other keys 
that transmit the same code as the terminal expects for the 
corresponding function, such as clear screen, the t e r m c a p 
2-letter codes can be given in the ko capability. For exam- 
ple, ;ko = cl , 1 1 , s f , sb : says that the terminal has clear, home 
down, scroll down, and scroll up keys that transmit the same 
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thing as the cl, 11, sf, and sb entries. 

The ma entry is also used to indicate arrow keys on termi- 
nals which have single character arrow keys. It is obsolete 
but still in use in version 2 of , which must be run on 
some minicomputers due to memory limitations. This field is 
redundant with kl , kr , ku , kd , and kh , It consists of’ 
groups of 2 chanac ter s . c In each group, the first character 
is what an arrow key sends, the vsecond “character is the 
corresponding ^ ' command. These commands are h for kl , j 
for kd , k for ku , 1 for kr, and H for kh . For example, the 
Mime would be ;ma= ^'K j'' Zk''Xl ; , indicating arrow keys left 
(''H), down ('“K), up (''Z), and right (''X). (There is no home 
key on the Mime , ) 

Miscellaneous 

If the terminal requires other than a null (zero) character 
as a pad, this can be given as pc. 

If tabs on the terminal require padding, or if the terminal 
uses a character other than to tab, this can be given as 
ta , 

Hazeltine terminals, which don’t allow characters to be 
printed, should indicate hz. Datamedia terminals, which 
echo carriage-return linefeed for carriage return and then 
ignore a following linefeed, should indicate nc. Early Con- 
cept terminals, which ignore a linefeed immediately after an 
am wrap, should indicate xn. If an erase-eol is required to 
get rid of standout (instead of merely writing on top of 
it), xs should be given. Teleray terminals, where tabs turn 
all characters moved over to blanks, should indicate xt. 
Other specific terminal problems may be corrected by adding 
more capabilities of the form x_x. 

Other capabilities include is, an initialization string for 
the terminal, and if, the name of a file containing long 
initialization strings. These strings are expected to prop- 
erly clear and then set the tabs on the terminal, if the 
terminal has settable tabs. If both are given, is will be 
printed before if. This is useful where if is 
/ usr / lib / tabset / std but is clears the tabs first. 


NOTE 

Ter mca p is based on software developed by The University of 
California, Berkeley, California, Computer Science Division, 
Department of Electrical Engineering and Computer Science. 

Ter mcap will be replaced by term in fo in the next release. 
Transition tools will be provided. 
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FILES 

/ etc/ termcap file containing terminal descriptions 

SEE ALSO 

ex(1), termcapO), vi(1) 

WARNINGS AND BUGS 

Ex allows only 256 characters for string capabilities, and 
the routines in termcap ( 3 ) do not check for overflow of this 
buffer. The total length of a single entry (excluding only 
escaped new-lines) may not exceed 1,02M. 

The ma, vs, and ve entries are specific to the program. 

Not all programs support all entries. There are entries 
that are not supported by any program. 
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special functions of HP 2640 and 2621 -series terminals /handle hp(1) 

/handle special functions of HP 2640 and 2621 -series terminals .... hp(1) 

functions of DASI 300 and 300s/ 300, 300s: handle special 300(1) 

handle special functions of DAST 300 and 300s terminals /300s: 300(1) 

DAST 300 and 300s/ 300, 300s: handle special functions of . 300(1) 

special functions of DASI 300 and 300s terminals /300s: handle 300(1) 

13tol , ltol3: convert between 3-byte integers and long/ 13tol(3C) 

comparison diff3: 3-way differential file diff3(1) 

4014 terminal 4014: paginator for the Tektronix . 4014(1) 

4014: paginator for the Tektronix 4014 terminal 4014(1) 

the DASI 450 terminal 450: handle special functions of .. 450(1) 

special functions of the DAST 450 terminal 450: handle 450(1) 

onyx: Onyx 6810 special system service onyx(2) 

onyx: Onyx 6810 special system service onyx(2) 

integer and base-64 ASCII/ a641, 164a: convert between long .. a641(3C) 

abort: generate an lOT fault abort (3C) 

value abs: return integer absolute abs(3C) 

abs: return integer absolute value abs(3C) 

fabs: floor, ceiling, remainder, absolute value functions /fmod, ... floor(3M) 

LP requests. accept, reject: allow/ prevent accept(IM) 

utime: set file access and modification times utime(2) 

a file touch: update access and modification times of .. touch(l) 

of a file access: determine accessibility ... access(2) 

machine/ sputl, sgetl : access long integer data in a sputl(3X) 

sadp: disk access profiler sadp(1) 

Idfcn: common object file access routines ldfcn(4) 

copy file systems for optimal access time, dcopy: dcopy(IM) 

/setutent, endutent, utmpname: access utmp file entry getut(3C) 

access: determine accessibility of a file access(2) 

acct: enable or disable process accounting acct(2) 

acctprcl, acctprc2: process accounting acctprc(IM) 

runacct: run daily accounting runacct(IM) 

acctcon2: connect-time accounting, acctconi, acctcon(IM) 

/accton, acctwtmp: overview of accounting and miscellaneous/ acct(IM) 

accounting and miscellaneous accounting commands, /of .......... acct(IM) 

acct: per-process accounting file format acct(4) 

acctcom: search and print process accounting file(s) acctcom(l) 

acctmerg: merge or add total accounting files acctmerg(IM) 

summary from per-process accounting records, /command acctcms(IM) 

wtmpfix: manipulate connect accounting records, fwtmp, fwtmp(IM) 

turnacct; shell procedures for accounting, /startup, acctsh(IM) 

accounting acct: enable or disable process ... acct(2) 
format acct: per-process accounting file . acct(4) 

per-process accounting/ acctcms: command summary from acctoms(IM) 

accounting file(s) acctcom: search and print process . acctcom(l) 

connect-time accounting. acctconi, acctcon2: acctcon(IM) 

accounting, acctconi, acctcon2: connect-time acctcon(IM) 

acctwtmp: overview of/ acctdisk, acctdusg, accton, acct(IM) 

overview of/ acctdisk, acctdusg, accton, acctwtmp: ....... acct(IM) 

accounting files. acctmerg: merge or add total ...... acctmerg(IM) 
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acctdisk, acctdusg, accton, acctwtmp: overview of/ .... acct(IM) 

accounting. acctprcl, acctprcP; process acctprc(IM) 

acctprcl, acctprcP: process accounting acctprc(IM) 

acctdisk, acctdusg, accton, acctwtmp: overview of/ acct(IM) 

functions sin, cos, tan, asin, acos, atan, atan2: trigonometric trig(3M) 

killall: kill all active processes killalKiM) 

sag: system activity graph sag(1) 

sal, sa2, sadc: system activity report package sar(IM) 

sar : system activity reporter sar(l) 

report process data and system activity timex : time a command; ... timex(l) 

formatting/ mosd : the OSDD adapter macro package for mosd(5) 

adduser: add a user to the system , adduser(IM) 

acctmerg: merge or add total accounting files acctmergCiM) 

adduser: add a user to the system , adduser (1M) 

alarm: set a process's alarm clock alarra(2) 

clock alarm: set a process's alarm alarm(2) 

sbrk: change data segment space allocation brk, brk(2) 

realloc, calloc: main memory allocator malloc, free, mallocOC) 

accept, reject: allow/ prevent LP requests accept(IM) 

fsba: file system block analyzer fsba(IM) 

sort: sort and/or merge files sort(1) 

link editor output a .out : common assembler and a. out (4) 

aouthdr: optional aout header aouthdr(4) 

aouthdr: optional aout header aouthdr(4) 

introduction to commands and application programs intro: intro(l) 

maintenance commands and application programs, /system intro(IM) 

maintainer for portable/ ar : archive and library ar(1) 

ar: common archive file format .... ar(4) 
language be: . arbitrary-^precision arithmetic .... bed) 

cpio: format of cpio archive cpio(4) 

for portable archives ar : archive and library maintainer .... ar(1) 

ar : common archive file format ar(4) 

archive header of a member of an archive file Idahread: read the ... ldahread(3X) 

archive file Idahread; read the archive header of a member of an .. ldahread(3X) 

tar: tape file archiver tar(1) 

library maintainer for portable archives ar : archive and ar(1) 

cpio: copy file archives in and out cpio(l) 

command xargs: construct argument list(s) and execute xargs(l) 

getopt: get option letter from argument vector getopt(3C) 

echo: echo arguments echo(l) 

expr: evaluate arguments as an expression expr(1) 

be: arbitrary^precision arithmetic language bcCl) 

number facts arithmetic: provide drill in ar ithmetic(6) 

expr: evaluate arguments as an expression expr(l) 

as** common assembler as(1) 

asa: interpret ASA carriage control characters ... asa(1) 

control characters asa: interpret ASA carriage asaCi) 

ascii: map of ASCII character set ascii(5) 

set ascii; map of ASCII character ascii(5) 

between long integer and base-64 ASCII string /164a: convert a641(3C) 

number atof: convert ASCII string to floating-point .... atof(3C) 

time/ ctime, localtime, gmtime, asetime, tzset; convert date and .. ctime(3C) 
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trigonometric/ sin, cos, tan, asin, acos, atan, atan2: trig(3M) 

help; ask for help help(1) 

as- common assembler as(1) 

a. out: common assembler and link editor output .. a.out(M) 

assert; verify program assertion .. assert(3X) 

assert; verify program assertion assert(3X) 

setbuf : assign buffering to a stream setbuf(3S) 

/list the spared sectors associated with a slice sparelist(8) 

sin, cos, tan, asin, acos, atan, atan2; trigonometric/ trig(3M) 

sin, cos, tan, asin, acos, atan, atan?: trigonometric functions trig(3M) 

floating-^point number atof; convert ASCII string to atof(3C) 

strtol, atol, atoi: convert string to integer ... strtol(3C) 

integer strtol, atol, atoi: convert string to ..... strtol(3C) 

wait: await completion of process ....... wait(1) 

processing language awk: pattern scanning and awk(1) 

ungetc: push character back into input stream ungetc(3S) 

back; the game of backgammon back(6) 

back: the game of backgammon back(6) 

fine: fast incremental backup, finc(IM) 

daily/weekly UNIX file system backup, filesave, tapesave: filesave(IM) 

free: recover files from a backup tape frec(IM) 

spare: replace a bad sector with a spare one spare(8) 

banner; make posters banner(l) 

termcap: terminal capability data base termcap(5) 

convert between long integer and base-64 ASCII string /164a; a641(3C) 

oriented (visual) display editor based on ex vi; screen vi(1) 

portions of pathnames basename, dirname; deliver basename(l) 

arithmetic language be: arbitrary-precision bed) 

system initialization/ bre, bcheckrc , rc , powerfail; brc(IM) 

bcopy; interactive block copy bcopy(IM) 

files bdiff; file comparator for large .. bdiff(l) 

cb : C program beaut ifier cbCl) 

j^* jn, yO, y1, yn; Bessel functions bessel(3M) 

bfs; big file scanner bfs(1) 

fread, fwrite; binary input/output fread(3S) 

bsearch; binary search bsearch(3C) 

• tsearch, tdelete, twalk: manage binary search trees tsearch(3C) 

b j : the game of black jack bj(6) 

b j ; the game of black jack bj(6) 

sync: update the super block sync(l) 

fsba: file system block analyzer fsba(IM) 

' V . bcopy; interactive block copy bcopy(IM) 

sum: print checksum and block count of a file sum(1) 

df; report number of free disk blocks. df(1M) 

system initialization shell/ bre, bcheckrc, rc , powerfail: brcClM) 

space allocation brk, sbrk; change data segment .... brk(2) 

modest-sized programs bs; a compiler/interpreter for .... bs(1) 

bsearch; binary search bsearch(3C) 

stdio: standard buffered input/output package stdio(3S) 

setbuf: assign buffering to a stream setbuf (3^>) 

mknod ; build special file. mknod(IM) 

swab: swap bytes swab(3C) 
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cc- C compiler cc(1) 

cflow: generate C flow graph cflow(l) 

cpp: the C language preprocessor cpp(1) 

cb : C program beautifier cb(1) 

lint: a C program checker lint(1) 

cxref: generate C program cross-reference cxrefd ) 

cal: print calendar cal(l) 

dc: desk calculator dc(1) 

cal: print calendar cal(1) 

calendar: reminder service calendar(l) 

cu: call another UNIX SYSTEM V system . cu(1C) 

data returned by stat system call stat: stat(5) 

malloc, free, realloc, calloc: main memory allocator mallocOC) 

intro: introduction to system calls and error numbers intro(2) 

link and unlink system calls, link, unlink: exercise link(IM) 

an LP line printer Ip, cancel: send/cancel requests to ... lp(1) 

termcap: terminal capability data base ,,,, termcap(5) 

asa: interpret ASA carriage control characters ....... asa(1) 

text editor (variant of ex for casual users) edit: edit(l) 

cat: concatenate and print files .. cat(1) 
cat: phototypesetter interface .... cat(7) 

cb: C program beautifier cb(1) 

cc- C compiler cc(1) 

cd : change working directory cd(1) 

remainder, absolute value/ floor, ceil, fmod , fabs: floor, ceiling, . floor(3M) 

floor, ceil, fmod, fabs: floor, ceiling, remainder, absolute/ floor(3M) 

cflow: generate C flow graph cflow(l) 

pipe: create an interprocess channel pipe(2) 

ungetc: push character back into input stream ,, ungetc(3S) 

neqn eqnchar : special character definitions for eqn and . eqnchar(5) 

cuserid: get character login name of the user ,. cuserid(3S) 

getc, getchar, fgetc, getw: get character or word from stream getc(3S) 

putc , putchar , fputc, putw: put character or word on a stream putc(3S) 

ascii: map of ASCII character set ascii(5) 

tr : translate characters tr(1) 

interpret ASA carriage control characters asa: asa(1) 

iscntrl, isascii: classify characters /isprint, isgraph,' ctype(3C) 

_tolower, toascii: translate characters /tolower, ^toupper, .... conv(3G) 

lastlogin, monacct, nulladra,/ chargefee, ckpacct, dodisk, acctsh(IM) 

chdir: change working directory ... chdir(2) 
/dfsck: file system consistency check and interactive repair, ..... fsck(IM) 

checking procedure. checkall: faster file system checkall(IM) 

text for troff cw, checkcw: prepare constant-width ... cw(1) 

for nroff or troff eqn, neqn, checkeq: format mathematical text . eqn(1) 

lint: a C program checker lint(l) 

grpck: password/group file checkers, pwck, pwck(IM) 

checkall: faster file system checking procedure checkalKiM) 

copy file systems with label checking, volcopy, labelit: ....... volcopy(IM) 

copy file systems with label checking, volcopy, labelit: volcopy. 1m. old 

processed by fsck checklist: list of file systems ... checklist(M) 

formatted with the MM/ mm, osdd, checkmm: print/check documents .... mm(1) 

file sum: print checksum and block count of a sum(1) 
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chess: the game of chess chess(6) 

chess: the game of chess chess(6) 

chown, chgrp: change owner or group chown(l) 

times: get process and child process times times(2) 

terminate wait: wait for child process to stop or wait(2) 

chjnod : change mode chmod(l) 

chmod : change mode of file chinod(2) 

a file chown: change owner and group of ,, chown(2) 

group chown, chgrp: change owner or chown(l) 

for a command. chroot; change root directory chroot(IM) 

chroot: change root directory ..... chroot(2) 

monacct, nulladm,/ chargefee, ckpacct, dodisk, lastlogin, acctsh(IM) 

isgraph, iscntrl, isascii: classify characters /isprint, ctype(3C) 

uuclean: uucp spool directory clean-up. uuclean(IM) 

clri: clear i-node clri(IM) 

inquiries ferror, feof, clearerr, fileno: stream status ... ferrorOS) 

alarm: set a process’s alarm clock alarm(2) 

cron: clock daemon. cron(IM) 

clock: report CPU time used clock(3C) 

Idclose, Idaclose: close a common object file ldclose(3X) 

close: close a file descriptor close(2) 

close: close a file descriptor .... close(2) 

fclose , fflush: close or flush a stream fclose(3S) 

clri: clear i-node clri(IM) 

cmp: compare two files cmp(1) 

/idint, real, float, sngl, dble, cmplx , dcmplx, ichar, char:/ ftype(3F) 

col: filter reverse line-feeds .... col(l) 

common to two sorted files comm: select or reject lines coram(l) 

system: issue a shell command system(3S) 

test: condition evaluation command test(1) 

time: time a command timed) 

nice: run a command at low priority nice(1) 

change root directory for a command, chroot: chroot(IM) 

env : set environment for command execution env(1) 

uux : Unix to unix command execution uux(IC) 

quits nohup: run a command immune to hangups and nohupCl) 

getopt: parse command options getopt(l) 

/shell, the standard/restricted command programming language sh(1) 

system activity timex : time a command; report process data and .. timex(l) 

per-process/ acctcms: command summary from acctcms(IM) 

argument list(s) and execute command xargs: construct xargs(l) 

install: install commands instalKiM) 

mk: how to remake the system and commands rak(8) 

programs intro: introduction to commands and application ...' introd) 

/to system maintenance commands and application/ introClM) 

and miscellaneous accounting commands, /of accounting acctClM) 

ar: common archive file format ar(4) 

as- common assembler asCl) 

output a. out: common assembler and link editor .. a.out(4) 

Idclose, Idaclose: close a common object file ldclose(3X) 

/section header of a common object file ldshread(3X) 

linenum: line number entries in a common object file linenum(4) 
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nm: print name list of common object file nm(1) 

scnhdr: section header for a common object file scnhdr(M) 

routines Idfcn: common object file access ldfcn(4) 

Idopen, Idaopen: open a common object file for reading .... ldopen(3X) 

/line number entries of a common object file function ldlread(3X) 

read the file header of a common object file Idfhread: ldfhread(3X) 

seek to the symbol table of a common object file Idtbseek: ldtbseek(3X) 

indexed symbol table entry of a common object file /read an ldtbread(3X) 

relocation information for a common object file reloc: reloc(4) 

entries of a section of a common object file /relocation ldrseek(3X) 

to the optional file header of a common object file /seek ldohseek(3X) 

to an indexed/named section of a common object file /seek ldsseek(3X) 

number entries of a section of a common object file /seek to line ldlseek(3X) 

format syras: common object file symbol table ... syms(4) 

of a symbol table entry of a common object file /the index ldtbindex(3X) 

filehdr: file header for common object files filehdr(4) 

Id: link editor for common object files ld(1) 

size: print section sizes of common object files size(l) 

comm; select or reject lines common to two sorted files comm(l) 

ipcs: report inter-process communication facilities status ... ipcs(l) 

stdipc: standard interprocess communication package stdipc(3C) 

diff: differential file comparator diff(1) 

bdiff; file comparator for large files bdiff(l) 

cmp; compare two files cmp(1) 

diff3: 3'^way differential file comparison diff3(l) 

dircrap: directory comparison dircrap(l) 

regcmp: regular expression compile regcmp(l) 

expression regcmp, regex; compile and execute a regular regcmp(3X) 

regexp; regular expression compile and match routines regexp(5) 

cc- G compiler cc(1) 

yacc : yet another compiler-compiler yacc(1) 

modest-sized programs bs; a compiler/interpreter for bs(1) 

erf, erfc; error function and complementary error function erf(3M) 

wait: await completion of process wait(1) 

pack, peat, unpack; compress and expand files pack(l) 

table entry of a/ Idtbindex: compute the index of a symbol ldtbindex(3X) 

cat: concatenate and print files cat(1) 

synchronous printer scat: concatenate and print files on .... scat(1) 

test; condition evaluation command test(1) 

config: configure UNIX SYSTEM V. .. config .68( 1M) 

system. Ipadmin: configure the LP spooling Ipadmin(IM) 

config: configure UNIX SYSTEM V config ,68( 1M) 

fwtmp, wtmpfix: manipulate connect accounting records fwtmp(IM) 

an out-going terminal line connection dial: establish dial(3C) 

acctconi, acctcon2: connect-time accounting acctcon(IM) 

fsck, dfsck: file system consistency check and/ fsck(IM) 

report and interactive status console rjestat: RJE status rjestat(IC) 

cw, checkew: prepare constant-width text for troff cw( 1 ) 

mkfs; construct a file system mkfs(IM) 

execute command xargs; construct argument list(s) and .... xargs(l) 

remove nroff/troff, tbl, and eqn constructs deroff: deroff(l) 

Is: list contents of directories ls(1) 
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csplit: context split csplit(l) 

fcntl : file control fcntl(2) 

vc: version control vc(1) 

asa : interpret ASA carriage control characters asa(1) 

ioctl: control device ioctl(2) 

init, telinit; process control initialization init(IM) 

msgctl : message control operations rasgctl(2) 

semctl : semaphore control operations semctl(2) 

shmctl : shared memory control operations shractl(2) 

fcntl; file control options fcntl(5) 

UUCP status inquiry and job control uustat: uustat(IC) 

tty; controlling terminal interface .... tty(7) 

term; conventional names for terminals ,, term(5) 

units; conversion program units(l) 

dd ; convert and copy a file dd(1) 

floating-point number atof; convert ASCII string to atof(3C) 

and long integers 13tol, ltol3: convert between 3-byte integers ... 13tol(3C) 

base-54 ASCII/ a641, 164a; convert between long integer and .. a641(3C) 

/gmtime, asctime, tzset: convert date and time to string ... ctime(3C) 

and VAX'^1 1/780/ fscv : convert files between M68000 fscv(IM) 

string ecvt, fcvt, gcvt; convert floating-point number to .. ecvt(3C) 

scanf, fscanf, sscanf; convert formatted input scanf(3S) 

strtol, atol , atoi; convert string to integer strtol(3C) 

bcopy; interactive block copy bcopy(IM) 

UUCP, uulog, uuname; unix to unix copy uucp(IC) 

dd; convert and copy a file dd(1) 

cpio: copy file archives in and out ..... cpio(l) 

access time, dcopy: copy file systems for optimal dcopy(IM) 

checking, volcopy, labelit: copy file systems with label volcopy(IM) 

checking, volcopy, labelit; copy file systems with label volcopy. 1m. old 

cp. In, mv; copy, link or move files cp(1) 

UNIX System- to-UN IX System file copy uuto, uupick; public uuto(IC) 

core; format of core image file ... core(4) 

core; format of core image file core(4) 

mem, kmem; core memory mem(7) 

atan2; trigonometric/ sin, cos, tan, asin, acos, atan, trig(3M) 

sinh, cosh, tanh; hyperbolic functions .. sinh(3M) 

wc ; word count wc(1) 

sum; print checksum and block count of a file sum(1) 

files cp. In, mv; copy, link or move .... cp(1) 

cpio; format of cpio archive cpio(4) 

out cpio: copy file archives in and ... cpio(1) 

cpio: format of cpio archive cpio(4) 

cpp; the C language preprocessor .. cpp(1) 

clock: report CPU time used clock(3C) 

craps: the game of craps oraps(6) 

craps: the game of craps craps(6) 

crash: examine system images crash(IM) 

crashes crash: what to do when the system . crash .m68(8) 

crash: what to do when the system crashes crash. m68(8) 

rewrite an existing one creat: create a new file or creat(2) 

file tmpnam, terapnam: create a name for a temporary tmpnam(3S) 
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existing one creat: create a new file or rewrite an ... creat( 2 ) 

fork: create a new process fork( 2 ) 

tmpfile: create a temporary file tmpfile( 3 S) 

pipe: create an interprocess channel .... pipe( 2 ) 

umask: set and get file creation mask uraask( 2 ) 

cron: clock daemon. cron(IM) 

cxref: generate C program cross-reference cxref(l) 

DES encryption crypt, setkey, encrypt: generate crypt(3C) 

csplit: context split csplit(l) 

terminal ct: spawn getty to a remote ct(IC) 

terminal ctermid: generate filename for ctermid( 3 S) 

asctime, tzset: convert date and/ ctime, local time, gmtime, ctirae(3C) 

cu: call another UNIX SYSTEM V system cu(IC) 

ttt , cubic: tic-tac-toe ttt( 6 ) 

uname: get name of current operating system uname( 2 ) 

uname: print name of current UNIX System uname(l) 

the slot in the utmp file of the current user ttyslot: find ttyslot(3C) 

getcwd : get pathname of current working directory getcwd(3C) 

of the user cuserid : get character login name . cuserid(3S) 

each line of a file cut: cut out selected fields of ... cut( 1 ) 

line of a file cut: cut out selected fields of each ... cut( 1 ) 

constant-width text for troff cw, checkcw: prepare cw( 1 ) 

cross-reference cxref: generate C program cxref(l) 

cron: clock daemon. cron(IM) 

errdemon: error-logging daemon. errdemon(IM) 

Ipd: line printer daemon Ipd(IC) 

terminate the error-logging daemon, errstop: errstop(IM) 

runacct: run daily accounting runacct(IM) 

backup, filesave, tapesave: daily/weekly UNIX file system filesave(IM) 

/ 300 s: handle special functions of DASI 300 and 300s terminals 300(1) 

handle special functions of the DASI 450 terminal 450: 450(1) 

prof: display profile data prof(l) 

time a command; report process data and system activity timex : ... timex(l) 

termcap: terminal capability data base .• termcap( 5 ) 

sputl , sgetl: access long integer data in a machine independent/ .... sputl(3X) 

plock: lock process, text, or data in memory plock( 2 ) 

call stat: data returned by stat system stat( 5 ) 

brk, sbrk: change data segment space allocation brk( 2 ) 

types: primitive system data types types( 5 ) 

join: relational database operator join(l) 

date: print and set the date dated) 

date: print and set the date date, 1 . old 

/gmtime, asctime, tzset: convert date and time to string ctime(3C) 

date: print and set the date dated) 

date: print and set the date date. 1 . old 

/ifix, idint, real, float, sngl, dble, cmplx , dcmplx, ichar , char:/ ftype(3F) 

dc; desk calculator dc( 1 ) 

/real, float, sngl, dble, cmplx, dcmplx, ichar, char: explicit/ .... ftype( 3 F) 

optimal access time. dcopy: copy file systems for ...... dcopy(IM) 

dd : convert and copy a file dd( 1 ) 

fsdb, fsdbib: file system debugger fsdb(IM) 

sdb: symbolic debugger sdb( 1 ) 
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sysdef: system definition sysdef(IM) 

eqnchar : special character definitions for eqn and neqn eqnchar(5) 

basename, dirname: deliver portions of pathnames basename(l) 

tail: deliver the last part of a file ... tail(1) 

mesg: permit or deny messages raesg(l) 

and eqn constructs deroff: remove nroff/troff, tbl , .. deroffCl ) 

crypt, setkey, encrypt: generate DES encryption crypt (3C) 

close: close a file descriptor close(2) 

dup: duplicate an open file descriptor dup(2) 

dc: desk calculator dcCi) 

file access: determine accessibility of a access(2) 

file: determine file type file(1) 

ioctl : control device ioctl(2) 

master: master device information table master ,dec(4) 

devnm: device name devnm(IM) 

devnm: device name devnm(IM) 

blocks. df: report number of free disk .... df(1M) 
check and interactive/ fsck, dfsck: file system consistency .... fsck(IM) 

terminal line connection dial: establish an out--going dial(3G) 

comparator diff: differential file diff(l) 

comparison diff3: 3^way differential file .... diff3(1) 

sdiff: side^-by-^-side difference program sdiff(l) 

diffmk: mark differences between files diffrak(l) 

diff: differential file comparator ...... diff(1) 

diff3: 3T>way differential file comparison diff3(1) 

files difftnk: mark differences between .. diffmk(l) 

dir: format of directories dir(4) 

dircmp: directory comparison dircmp(l) 

dir: format of directories dir(4) 

Is: list contents of directories ls(1) 

rm, rmdir: remove files or directories rm(1) 

cd : change working directory cd(1) 

chdir: change working directory chdir(2) 

chroot: change root directory chroot(2) 

rakdir: make a directory mkdir(l) 

mvdir: move a directory mvdir(IM) 

uuclean: uucp spool directory clean-r-up uuclean(IM) 

dircmp: directory comparison dircrap(l) 

unlink: remove directory entry unlink(2) 

chroot: change root directory for a command chroot (1M) 

get pathname of current working directory getcwd : getcwd(3C) 

pwd : working directory name pwd(1) 

ordinary file mknod : make a directory, or a special or mknod(2) 

pathnames basename, dirname: deliver portions of basename(l) 

printers enable, disable: enable/disable LP enabled ) 

acct: enable or disable process accounting acct(2) 

type, modes, speed, and line discipline, /set terminal getty(IM) 

sadp: disk access profiler sadp(1) 

df: report number of free disk blocks df(1M) 

du: summarize disk usage du(1) 

mount, umount: mount and diauount file system mount(IM) 

vi : screen oriented (visual) display editor based on ex vi(1) 
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prof: display profile data prof( 1 ) 

hypot: Euclidean distance function hypot( 3 M) 

/IcongMS: generate uniformly distributed pseudo-random/ drandJ48(3C) 

mm, osdd , checkmm: print/ check documents formatted with the MM/ .. mm( 1 ) 

MM macro package for formatting documents mm: the mm (5) 

macro package for formatting documents /the OSDD adapter mosd( 5 ) 

slides mmt, mvt: typeset documents, viewgraphs, and mmt( 1 ) 

nulladm,/ chargefee, ckpacct, dodisk, lastlogin, monacct, acctsh(IM) 

whodo: who is doing what. whodo(IM) 

reversi : a game of dramatic reversals reversi( 6 ) 

nrand^S, mrand48, jrand48,/ drand48, erand48, lrand48, drand48(3C) 

arithjnetic : provide drill in number facts arithmetic( 6 ) 

trace: event^tracing driver trace(7) 

du: summarize disk usage du( 1 ) 

od : octal dump odd) 

object file dump: dump selected parts of an ... dump( 1 ) 

extract error records from dump, errdead: errdeadCiM) 

file dump: dump selected parts of an object .. dump( 1 ) 

descriptor dup: duplicate an open file dup( 2 ) 

descriptor dup: duplicate an open file dup( 2 ) 

echo: echo arguments echo(l) 

echo: echo arguments echo(l) 

floating-point number to string ecvt, fcvt, gcvt: convert ecvt(3C) 

ed , red: text editor ed(l) 

end, etext, edata: last locations in program .. end ( 3 c) 

for casual users) edit: text editor (variant of ex .. edit(l) 

ed , red : text editor ed( 1 ) 

ex: text editor ex( 1 ) 

sed : stream editor sed(l) 

screen oriented (visual) display editor based on ex vi: vi( 1 ) 

Id: link editor for common object files .... ld( 1 ) 

common assembler and link editor output a. out: a.out(4) 

users) edit: text editor (variant of ex for casual .. edit( 1 ) 

effective user, real group, and effective group IDs /real user, ... getuid(2) 

/getgid, getegid: get real user, effective user, real group, and/ .. getuid( 2 ) 

fsplit: split f 77 , ratfor, or efl files fsplit(l) 

pattern grep, egrep, fgrep: search a file for a . grep( 1 ) 

LP printers enable, disable: enable/disable ... enabled ) 

accounting acct: enable or disable process acct( 2 ) 

enable, disable: enable/disable LP printers enabled ) 

crypt, setkey, encrypt: generate DES encryption .. crypt(3C) 

setkey, encrypt: generate DES encryption crypt, crypt (3C) 

makekey: generate encryption key makekeyd) 

in program end, etext, edata: last locations . end(3C) 

getgrgid, getgrnam, setgrent, endgrent: obtain getgrent, getgrent(3C) 

/getpwuid, getpwnam, setpwent, endpwent: get password file/ ...... getpwent(3C) 

/getutline, pututline, setutent, endutent, utmpname: access utmp/ .. getut(3C) 

nlist: get entries from name list nlist(3C) 

linenum: line number entries in a common object file ... linenum(4) 

man, manprog: print entries in this manual mand) 

man: macros for formatting entries in this manual man( 5 ) 

/Idlitem: manipulate line number entries of a common object file/ .. ldlread(3X) 
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/Idnlseek: seek to line number entries of a section of a common/ . ldlseek(3X) 

/Idnrseek: seek to relocation entries of a section of a common/ . ldrseek(3X) 

putpwent; write password file entry putpwent(3C) 

unlink: remove directory entry unlink(2) 

utmp, wtmp: utmp and wtrop entry formats utmp(4) 

endpwent: get password file entry /getpwnam, setpwent, getpwent(3C) 

/the index of a symbol table entry of a common object file ldtbindex(3X) 

/read an indexed symbol table entry of a common object file ldtbread(3X) 

utmpname: access utmp file entry /setutent, endutent, getut(3C) 

execution env: set environment for command env(1) 

environ; user environment environ(5) 

environ: user environment environ(5) 

profile: setting up an environment at login time profile(4) 

execution env: set environment for command env(1) 

getenv : return value for environment name getenv(3C) 

sky: obtain ephemerides sky(6) 

special character definitions for eqn and neqn eqnchar : Gqnchar(5) 

•remove nroff/troff, tbl , and eqn constructs deroff: deroff(l) 

mathematical text for nroff or/ eqn, neqn, checkeq: format eqn(1) 

definitions for eqn and neqn eqnchar: special character eqnchar (5) 

mrand48, jrand48,/ drand48, erand48, lrand48, nrand48, drand48(3C) 

complementary error function erf, erfc; error function and erf(3M) 

complementary error/ erf, erfc: error function and erf(3M) 

err: error-logging interface err(7) 

from dump. errdead: extract error records .... errdead(lM) 

daemon. errdemon: error-logging errdemon(IM) 

errfile: error-log file format .... errfile(4) 

system error messages perror, errno, sys__errlist , sys__nerr : perror(3C) 

error function erf, erfc: error function and complementary .. erf(3M) 

error function and complementary error function erf, erfc: erf(3M) 

sys__errlist , sys__nerr : system error messages perror, errno, perror (3C) 

introduction to system calls and error numbers intro: intro(2) 

errdead: extract error records from dump errdead (1M) 

matherr: error-handling function matherr(3M) 

errfile: error-log file format errfile(4) 

errdemon: error-logging daemon errdononC 1M) 

errstop: terminate the error-logging daemon errstop(IM) 

err: error-logging interface err(7) 

process a report of logged errors, errpt: errpt(IM) 

spellin, hashcheck: find spelling errors spell, hashmake, spell(l) 

logged errors. errpt: process a report of errpt(IM) 

error-logging daemon, errstop; terminate the errstop(IM) 

line connection dial: establish an out-going terminal ... dial(3C) 

setmnt: establish mount table ' setmnt(IM) 

program end, etext, edata: last locations in ... end(3C) 

hypot: Euclidean distance function hypot(3M) 

expression expr: evaluate arguments as an expr(l) 

test; condition evaluation command test(1) 

trace: event-tracing driver trace(7) 

edit: text editor (variant of ex for casual users) edit(1) 

ex: text editor ex(1) 

(visual) display editor based on ex vi: screen oriented vi(1) 
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crash: examine system images crash(IM) 

execlp, execvp: execute a file execl, execv, execle, execve, exec(2) 

execute a file execl, execv, execle, execve, execlp, execvp: ... exec(?) 

execl, execv, execle, execve, execlp, execvp: execute a file .... exec(2) 

execle, execve, execlp, execvp: execute a file execl, execv, exec(2) 

regcmp, regex: compile and execute a regular expression regcmp(3X) 

construct argument list(s) and execute command xargs: xargs(l) 

env: set environment for command execution env(1) 

uux : Unix to unix command execution uux(IC) 

sleep: suspend execution for an interval sleep(l) 

sleep: suspend execution for interval sleepOC) 

monitor: prepare execution profile raonitor(3C) 

profil: execution time profile profil(2) 

execvp: execute a file execl, execv, execle, execve, execlp, .... exec(2) 

file execl, execv, execle, execve, execlp, execvp: execute a . exec(2) 

execv, execle, execve, execlp, execvp: execute a file execl, ..... exec(2) 

system calls, link, unlink: exercise link and unlink link(IM) 

create a new file or rewrite an existing one creat: creat(2) 

exit, _^exit: terminate process .... exit(2) 

exit, __exit: terminate process exit(2) 

exponential, logarithm, power,/ exp, log, loglO, pow, sqrt: exp(3M) 

pack, peat, unpack: compress and expand files pack(l) 

exp, log, logic, pow, sqrt: expKDnential , logarithm, power,/ ... exp(3M) 

expression expr; evaluate arguments as an .... expr(l) 

expr: evaluate arguments as an expression expr(l) 

regcmp: regular expression compile regcrap(l) 

routines regexp: regular expression compile and match regexp(5) 

compile and execute a regular expression regcmp, regex: regcmp(3X) 

greek: graphics for the extended 111-^37 type-^-box greek(5) 

dump, errdead: extract error records from errdead(IM) 

fsplit: split f77, ratfor, or efl files fsplit(l) 

absolute/ floor, ceil, fraod , fabs: floor, ceiling, remainder, .. floor(3M) 

factor: factor a number factor(l) 

factor: factor a number factor(l) 

true, false: provide truth values trued ) 

data in a machine independent fashion, /access long integer sputl(3X) 

fine: fast incr«nental backup finc(lM) 

procedure, checkall: faster file system checking checkalKiM) 

abort: generate an lOT fault abort(3C) 

stream fclose, f flush: close or flush a .. fclose(3S) 

fcntl: file control fcntl(2) 

fcntl; file control options fcntl (5) 

floating-point number to/ ecvt, fevt, gevt: convert ecvt(3C) 

fopen, f reopen, fdopen: open a stream fopen(3S) 

status inquiries ferror, feof, clearerr, fileno: stream .... ferror(3S) 

stream status inquiries ferror, feof, clearerr, fileno: ... ferror(3S) 

statistics for a file system. ff: list file names and ff(1M) 

fclose, fflush: close or flush a stream ... fclose(3S) 

word from stream getc, getchar, fgetc, getw: get character or getc(3S) 

stream gets, fgets: get a string from a gets(3S) 

pattern grep, egrep, fgrep: search a file for a grepCl ) 

chmod : change mode of file chmod(2) 
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core: format of core image file core(4) 

dd : convert and copy a file dd(1) 

group: group file group(4) 

issue: issue identification file issue(4) 

link: link to a file link(2) 

mknod : build special file. rnknod(IM) 

null: the null file null(7) 

passwd : password file passwd(4) 

read: read from file read(2) 

tail: deliver the last part of a file tail(l) 

tmpfile: create a temporary file tinpfile(3S) 

uniq: report repeated lines in a file uniq(l) 

write: write on a file write(2) 

determine accessibility of a file access: access(2) 

times utime: set file access and modification utime(2) 

Idfcn: common object file access routines ldfcn(4) 

tar: tape file archiver tar(1) 

cpio: copy file archives in and out cpio(l) 

pwck, grpck: password/group file checkers pwck(IM) 

change owner and group of a file chown: chown(2) 

diff: differential file comparator diff(l) 

bdiff: file comparator for large files ... bdiff(l) 

diff3: 3'-way differential file comparison diff3(1) 

fcntl: file control fcntl(2) 

fcntl: file control options fcntl (5) 

public UNIX System-r-to-UNIX System file copy uuto, uupick; uuto(IC) 

umask: set and get file creation mask umask(2) 

selected fields of each line of a file cut: cut out cut(1) 

close: close a file descriptor olose(2) 

dup: duplicate an open file descriptor dup(2) 

file: determine file type filed) 

dump selected parts of an object file dump: dumpCi) 

putpwent: write password file entry putpwent(3C) 

setpwent, endpwent: get password file entry /getpwuid , getpwnam, ... getpwent(3C) 

endutent, utrapname: access utmp file entry /pututline, setutent, .. getut(3C) 

execve, execlp, execvp: execute a file execl, execv, execle, exec(2) 

grep, egrep, fgrep: search a file for a pattern grep(1) 

Idaopen: open a common object file for reading Idopen, ldopen(3X) 

acct: per-T-process accounting file format acct(4) 

ar : common archive file format ar(4) 

err file: error^log file format errfile(4) 

intro: introduction to file formats intro(4) 

number entries of a common object file function /manipulate line .... ldlread(3X) 

files filehdr: file header for common object filehdr(4) 

file Idfhread: read the file header of a common object .... ldfhread(3X) 

Idohseek: seek to the optional file header of a common object/ ... ldohseek(3X) 

split: split a file into pieces splitCl) 

header of a member of an archive file Idahread: read the archive ... ldahread(3X) 

Idaclose: close a common object file Idclose, ldclose(3X) 

file header of a common object file Idfhread; read the ldfhread(3X) 

retrieve symbol name for object file Idgetname: ldgetname( 3X) 

symbol table of a common object file Idtbseek: seek to the ldtbseek(3X) 
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number entries in a common object file linenum: line linenumCM) 

or a special or ordinary file mknod : make a directory, mknod(2) 

a file system, ff: list file names and statistics for ff(lM) 

change the format of a text file newform : newform(l) 

print name list of common object file nm: nm(1) 

/find the slot in the utmp file of the current user ttyslot(3C) 

creat: create a new file or rewrite an existing one ... creat(2) 

Iseek: move read/write file pointer lseek(2) 

rewind, ftell: reposition a file pointer in a stream fseek, ... fseek(3S) 

table entry of a common object file /read an indexed symbol ldtbread(3X) 

section header of a common object file /read an indexed/named ldshread(3X) 

information for a common object file reloc: relocation reloc(4) 

files or subsequent lines of one file /same lines of several pasted ) 

bfs; big file scanner bfsCl) 

header for a common object file scnhdr: section scnhdr(4) 

section of a common object file /seek to an indexed/named .... ldsseek(3X) 

of a section of a common object file /seek to relocation entries .. ldrseek(3X) 

file header of a common object file /seek to the optional ldohseek(3X) 

number information from an object file /strip symbol and line stripCl) 

checksum and block count of a file sum; print sum(1) 

syms: common object file symbol table format syms(4) 

mkfs: construct a file system mkfs(IM) 

mount: mount a file system mount(2) 

umount: unmount a file system umount(2) 

tapesave: daily/weekly UNIX file system backup, filesave, filesave(IM) 

fsba: file system block analyzer fsba(IM) 

procedure, checkall; faster file system checking checkalKiM) 

and interactive/ fsck, dfsck: file system consistency check fsck(IM) 

fsdb, fsdbib; file system debugger fsdb(IM) 

names and statistics for a file system, ff; list file ff(1M) 

volume file system; format of system fs(M) 

umount; mount and dismount file system, mount, mount(IM) 

ustat; get file system statistics ustat(2) 

mnttab ; mounted file system table ranttab(4) 

access time, dcopy; copy file systems for optimal dcopy(IM) 

checklist; list of file systems processed by fsck .... checklistCM) 

volcopy, labelit; copy file systems with label/ volcopy(IM) 

volcopy, labelit; copy file systems with label/ volcopy . 1m. old 

table entry of a common object file /the index of a symbol ldtbindex(3X) 

create a name for a temporary file tmpnam, tempnam; tmpnam(3S) 

of a section of a common object file /to line number entries ldlseek(3X) 

and modification times of a file touch; update access touch(l) 

ftw; walk a file tree ftw(3C) 

file; determine file type filed) 

umask: set file-r-creation mode mask umaskCl ) 

object files filehdr; file header for common ... filehdr(4) 

mktemp: make a unique filename mktemp(3C) 

ctermid ; generate filename for terminal ctermid(3S) 

ferror, feof, clearerr, fileno; stream status inquiries ... ferror(3S) 

bdiff; file comparator for large files bdiffCl) 

cat; concatenate and print files catCl) 

cmp; compare two files cmpCl ) 
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cp. In, mv ; copy, link or move files cp(1) 

diffmk: mark differences between files diffmk(l) 

find: find files find(l) 

intro: introduction to special files intro(7) 

Id: link editor for common object files ld(1) 

pr : print files pr(1) 

sort: sort and/or merge files sort(l) 

and print process accounting file(s) acctcom: search acctcom(l) 

merge or add total accounting files, acctmerg: acctmerg(IM) 

VAX-^1 1/780/ fscv : convert files between M68000 and fscv(IM) 

reject lines common to two sorted files comm: select or comm(l) 

file header for common object files filehdr: filehdr(4) 

free: recover files from a backup tape, frec(IM) 

format specification in text files fspec: fspec(4) 

split f77. ratfor, or efl files fsplit: fsplit(l) 

scat: concatenate and print files on synchronous printer scat(l) 

rm, rmdir: remove files or directories rm(1) 

/merge same lines of several files or subsequent lines of one/ , pasted ) 

peat, unpack: compress and expand files pack, pack(l) 

section sizes of common object files size: print size(1) 

daily/weekly UNIX file system/ filesave, tapesave: filesave(IM) 

greek: select terminal filter greekCl) 

nl : line numbering filter nl(1) 

col: filter reverse line-r<feeds cold) 

fine: fast incremental backup fincClM) 

find: find files findCl) 

find: find files findCi) 

hyphen: find hyphenated words hyphenCl) 

ttyname, isatty; find name of a terminal ttyname(3G) 

object library lorder: find ordering relation for an lorderCl) 

hashmake, spellin, hashcheck: find spelling errors spell, spell (1) 

the current user ttyslot: find the slot in the utmp file of . ttyslot(3C) 

tee: pipe fitting teeCl) 

ichar,/ int, ifix, idint, real, float, sngl, dble, cmplx , dcmplx, . ftype(3F) 

atof: convert ASCII string to floating-point number atof(3C) 

ecvt, fevt, gevt: convert floating-point number to string ... ecvt(3C) 

Idexp, modf: manipulate parts of floating-point numbers frexp, frexp(3C) 

ceiling, remainder, absolute/ floor, ceil, fmod , fabs: floor, ... floor(3M) 

floor, ceil, fmod, fabs: floor, ceiling, remainder,/ floor(3M) 

cflow: generate C flow graph cflowCl) 

fclose, fflush: close or flush a stream fclose(3S) 

remainder, absolute/ floor, ceil, fmod, fabs: floor, ceiling, floor(3M) 

stream fopen, freopen, fdopen: open a .... fopen(3S) 

fork: create a new process fork(2) 

acet: per-process accounting file format acct(M) 

ar : common archive file format ar(M) 

errfile: error-log file format errfile(M) 

nroff or/ eqn, neqn, checkeq: format mathematical text for eqn(l) 

newform: change the format of a text file newformCl) 

inode: format of an inode inode(il) 

core: format of core image file core(4) 

cpio: format of cpio archive cpio(4) 
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dir: format of directories dir(M) 

file system: format of system volume fs(4) 

files fspec : format specification in text fspec(M) 

common object file symbol table format syms: syms(M) 

tbl : format tables for nroff or troff .. tbl(1) 

nroff: format text nroff(l) 

intro: introduction to file formats introCM) 

utmp, wtmp: utmp and wtmp entry formats utmp(4) 

scanf, fscanf, sscanf: convert formatted input scanfOS) 

printf, fprintf, sprintf: print formatted output printf(3S) 

/checkmm: print/check documents formatted with the MM macros mm(1) 

mptx: the macro package for formatting a permuted index mptx(5) 

mm: the MM macro package for formatting documents mm (5) 

OSDD adapter macro package for formatting documents mosd : the mosd(5) 

manual man: macros for formatting entries in this man(5) 

output printf, fprintf, sprintf: print formatted . printfOS) 

word on a stream putc, putchar , fputc, putw: put character or putc(3S) 

puts, fputs: put a string on a stream ... puts(3S) 

input/output fread, fwrite: binary fread(3S) 

backup tape. free: recover files from a frec(IM) 

df: report number of free disk blocks df(1M) 

memory allocator malloc, free, realloc, calloc: main malloc(3C) 

fopen, f reopen, fdopen: open a stream .... fopen(3S) 

parts of floating-point numbers frexp, Idexp, modf: manipulate .... frexp(3C) 

free: recover files from a backup tape frec(IM) 

gets, fgets: get a string from a stream gets(3S) 

and line number information from an object file /symbol strip(l) 

getopt: get option letter from argument vector getopt(3C) 

errdead; extract error records from dump errdead(IM) 

read: read from file read(2) 

ncheck: generate names from i-nurabers ncheck(IM) 

nlist: get entries from name list nlist(3C) 

acetems: command summary from per-process accounting/ acctcms(IM) 

getw: get character or word from stream /getchar, fgetc, getc(3S) 

getpw: get name from UID getpw(3C) 

analyzer. fsba: file system block fsba(IM) 

input scanf, fscanf, sscanf: convert formatted . scanf(3S) 

list of file systems processed by fsck checklist: checklist(4) 

consistency check and/ fsck, dfsck: file system fsck(IM) 

M68000 and VAX-1 1/780/ fsev: convert files between fscv(IM) 

debugger. fsdb, fsdbib: file system fsdb(IM) 

fsdb, fsdbib: file system debugger fsdb(IM) 

a file pointer in a stream fseek, rewind, ftell : reposition .. fseek(3S) 

text files fspec; format specification in .... fspec(4) 

efl files fsplit: split f77, ratfor, or fsplit(l) 

in a stream fseek, rewind, ftell: reposition a file pointer .. fseek(3S) 

ftw; walk a file tree ftw(3C) 

gamma: log gamma function gamma(3M) 

hypot: Euclidean distance function hypot(3M) 

matherr : error-handling function matherr(3M) 

function erf, erfc: error function and complementary error .. erf(3M) 

function and complementary error function erf, erfc: error erf(3M) 
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entries of a common object file function /manipulate line number .. ldlread(3X) 

jO. jT* jn* yO, y1, yn: Bessel functions bessel(3M) 

sinh, cosh, tanh: hyperbolic functions sinh( 3 M) 

remainder, absolute value functions /fabs: floor, ceiling, .. floor( 3 M) 

300 , 300s: handle special functions of DASI 300 and 300s/ ... 300(1) 

2621^series/ hp: handle special functions of HP 2640 and hp(1) 

terminal 450: handle special functions of the DASI 450 450(1) 

acos, atan, atan 2 : trigonometric functions sin, cos, tan, asin, trig( 3 M) 

logarithm, power, square root functions /sqrt: exponential, exp( 3 M) 

fread, fwrite: binary input/butput fread( 3 S) 

connect accounting records. fwtrap, wtmpfix: manipulate fwtmp(IM) 

jotto: secret word game jotto( 6 ) 

moo: guessing game moo( 6 ) 

back: the game of backgammon back( 6 ) 

b j : the game of black jack bj( 6 ) 

chess: the game of chess chess( 6 ) 

craps: the game of craps craps( 6 ) 

reversi : a game of dramatic reversals reversi( 6 ) 

wump: the game of hunt-the-wumpus wump( 6 ) 

intro: introduction to games intro( 6 ) 

gamma: log gamma function gamma( 3 M) 

gamma: log gamma function gamma(3M) 

number to string ecvt, fcvt, gcvt: convert floating-^point ecvt(3C) 

maze: generate a maze maze( 6 ) 

abort: generate an lOT fault abort(3C) 

cflow: generate C flow graph cflow(l) 

cross-reference cxref: generate C program cxref(l) 

crypt, setkey, encrypt: generate DES encryption crypt (3C) 

makekey; generate encryption key makekey(l) 

ctermid: generate filename for terminal .... ctermid(3S) 

ncheck: generate names from i-numbers ncheck(IM) 

lexical tasks lex: generate programs for simple lex( 1 ) 

/srand48, seed48, lcong48: generate uniformly distributed/ ... drand48(3C) 

rand, srand: simple random-number generator rand(3C) 

gets, fgets: get a string from a stream gets(3S) 

ulimit: get and set user limits ulimit( 2 ) 

user cuserid: get character login name of the ... cuserid(3S) 

getc, getchar, fgetc, getw: get character or word from/ getc(3S) 

nlist: get entries from name list nlist(3C) 

umask: set and get file creation mask umask( 2 ) 

ustat: get file system statistics ustat( 2 ) 

getlogin: get login name getlogin(3C) 

logname: get login name logname(l) 

msgget: get message queue nisgget( 2 ) 

getpw: get name from UID getpw(3C) 

system uname: get name of current operating ..... uname( 2 ) 

vector getopt; get option letter from argument ... getopt(3C) 

/getpwnam, setpwent, endpwent: get password file entry getpwent(3C) 

directory getcwd : get pathname of current working ... getcwd(3C) 

times times: get process and child process ..... times( 2 ) 

parent/ getpid , getpgrp, getppid: get process, process group, and ... getpid( 2 ) 

getuid, geteuid, getgid , getegid; get real user, effective user,/ ... getuid( 2 ) 
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semget: get set of semaphores semget(2) 

shmget: get shared memory segment shinget(2) 

tty; get the terminal's name tty(1) 

time: get time time(2) 

character or word from stream getc, getchar, fgetc, getw: get ... getc(3S) 

character or word from/ getc, getchar, fgetc, getw: get getc(3S) 

working directory getcwd : get pathname of current ... getcwd(3C) 

user,/ getuid, geteuid , getgid, getegid : get real user, effective . getuid(2) 

environment name getenv: return value for getenv(3C) 

real user, effective/ getuid, geteuid, getgid, getegid: get ..... getuid(2) 

effective user,/ getuid, geteuid, getgid, getegid: get real user, ... getuid(2) 

setgrent, endgrent: obtain getgrent, getgrgid , getgrnam, getgrent(3C) 

endgrent; obtain getgrent, getgrgid, getgrnam, setgrent, getgrent(3C) 

obtain getgrent, getgrgid, getgrnan, setgrent, endgrent: getgrent(3C) 

getlogin: get login name getlogin(3C) 

argument vector getopt: get option letter from .... getopt(3C) 

getopt: parse command options getopt(l) 

getpass: read a password getpass(3C) 

process group, and/ getpid , getpgrp, getppid : get process, .... getpid(2) 

process, process group, and/ getpid, getpgrp, getppid; get getpid(2) 

group, and/ getpid, getpgrp, getppid: get process, process getpid(2) 

getpw; get name from DID getpw(3C) 

setpwent, endpwent: get password/ getpwent, getpwuid, getpwnam, ..... getpwent(3C) 

password/ getpwent, getpwuid, getpwnam, setpwent, endpwent: get . getpwent(3C) 

endpwent: get password/ getpwent, getpwuid, getpwnam, setpwent, getpwent(3C) 

stream gets, fgets: get a string from a .. gets(3S) 

and terminal settings used by getty gettydefs: speed gettydefsCM ) 

modes, speed, and line/ getty: set terminal type, getty(IM) 

ct: spawn getty to a remote terminal ct(1C) 

settings used by getty gettydefs: speed and terminal gettydefs(4) 

get real user, effective user,/ getuid, geteuid, getgid, getegid: . getuid(2) 

pututline, setutent, endutent,/ getutent, getutid, getutline, getut(3C) 

setutent, endutent,/ getutent, getutid, getutline, pututline, .... getut(3C) 

endutent,/ getutent, getutid, getutline, pututline, setutent, ... getut(3C) 

stream getc, getchar, fgetc, getw: get character or word from .. getc(3S) 

date and time/ ctime, localtime, gratirae, asctime, tzset: convert ... ctime(3C) 

setjmp, longjmp: non-local goto setjrap(3C) 

cflow: generate C flow graph cflow(l) 

sag: system activity graph sag(1) 

type-box greek: graphics for the extended TTY-37 .. greek(5) 

TTY-37 type-box greek: graphics for the extended .. greek(5) 

greek: select terminal filter greek(l) 

for a pattern grep, egrep, fgrep: search a file . grep(l) 

chown, chgrp: change owner or group chown(l) 

newgrp: log in to a new group newgrp(l) 

/real user, effective user, real group, and effective group IDs .... getuid(2) 

/getppid: get process, process group, and parent process IDs getpid(2) 

group: group file groupCM) 

group: group file group(4) 

setpgrp: set process group ID setpgrp(2) 

setuid, setgid:.set user and group IDs setuid(2) 

id: print user and group IDs and names id(1) 
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user, real group, and effective group IDs /real user, effective ... getuid(2) 

chown: change owner and group of a file chown(2) 

send a signal to a process or a group of processes kill: .......... kill(2) 

maintain, update, and regenerate groups of programs make: make(1) 

checkers, pwck, grpck: password/group file pwck(IM) 

ssignal, gsignal: software signals ssignaKSC) 

hangman: guess the word hangman(6) 

moo: guessing game raoo(6) 

300 and 300s/ 300, 300s: handle special functions of DASI .. 300(1) 

2640 and 2621 -^series/ hp: handle special functions of HP .... hp(1) 

DASI 450 terminal 450: handle special functions of the ,,, 450(1) 

hangman: guess the word hangman(6) 

nohup : run a command immune to hangups and quits nohup(l) 

hcreate, hdestroy: manage hash search tables hsearch, hsearch(3C) 

spell, hashmake, spellin, hashcheck: find spelling errors ... spell(l) 

find spelling errors spell, hashmake, spellin, hashcheck: ..... spell(l) 

search tables hsearch, hcreate, hdestroy: manage hash .... hsearch(3C) 

tables hsearch, hcreate, hdestroy: manage hash search hsearch(3C) 

aouthdr: optional aout header aouthdr(4) 

scnhdr: section header for a common object file ... scnhdr(4) 

filehdr; file header for common object files .... filehdr(4) 

Idfhread: read the file header of a ccmmon object file .... ldfhread(3X) 

/seek to the optional file header of a common object file .... ldohseek(3X) 

/read an indexed/named section header of a common object file .... ldshread(3X) 

file Idahread: read the archive header of a member of an archive .. ldahread(3X) 

help: ask for help help(l) 

help: ask for help help(1) 

hp: handle special functions of HP 2640 and 2621 -^series/ hp(1) 

HP 2640 and 2621 -r-series/ hp: handle special functions of ... hp(1) 

manage hash search tables hsearch, hcreate, hdestroy: hsearch(3C) 

. wump: the game of hunt-^the^^-wumpus wump(6) 

sinh, cosh, tanh: hyperbolic functions sinh(3M) 

hyphen: find hyphenated words hyphen(l) 

hyphen: find hyphenated words hyphen(l) 

function hypot: Euclidean distance hypot(3M) 

setpgrp: set process group ID setpgrp(2) 

names id: print user and group IDs and .. id(1) 

semaphore set or shared memory id /remove a message queue, ipcrm(l) 

issue: issue identification file issue(4) 

cmplx , dcmplx , ichar,/ int, ifix, idint, real, float, sngl, dble, ... ftype(3F) 

id: print user and group IDs and names id(1) 

process group, and parent process IDs /getppid: get process, getpid(2) 

real group, and effective group IDs /real user, effective user, ... getuid(2) 

setgid: set user and group IDs setuid, setuid(2) 

dble, cmplx, dcmplx, ichar,/ int, ifix, idint, real, float, sngl, ... ftype(3F) 

core: format of core image file core(4) 

crash: examine system images crash(IM) 

nohup: run a command immune to hangups and quits nohup(l) 

fine: fast increnental backup finc(lM) 

long integer data in a machine independent fashion, /access sputl(3X) 

/tgetstr, tgoto, tputs: terminal independent operation routines .... termcap(3) 

ptx: permuted index ptx(1) 
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package for formatting a permuted index mptx: the macro mptx(5) 

a common/ Idtbindex: compute the index of a symbol table entry of .. IdtbindexCSX; 
common object/ Idtbread: read an indexed symbol table entry of a ldtbread(3X) 

a/ Idshread, Idnshread: read an indexed/named section header of ... ldshread(3X) 

Idsseek, Idnsseek: seek to an indexed/named section of a/ ldsseek(3X) 

inittab: script for the init process inittabC^) 

initialization. init, telinit: process control .... init(IM) 

init, telinit: process control initialization init(IM) 

/rc, power fail: system initialization shell scripts brc(IM) 

popen, pclose : initiate pipe to/ from a process ... popen(3S) 

process inittab: script for the init inittab(4) 

clri: clear i*-node clri(IH) 

inode: format of an inode inode(4) 

inode: format of an inode inode(4) 

fscanf, sscanf: convert formatted input scanf, scanf(3S) 

ungetc: push character back into input stream ungetc(3S) 

fread, fwrite: binary input/output fread(3S) 

stdio: standard buffered input/output package stdio(3S) 

clearerr, fileno: stream status inquiries ferror, feof, ferror(3S) 

uustat: UUCP status inquiry and job control uustat(IC) 

install: install commands instalKiM) 

install: install commands instalKiM) 

sngl, dble, cmplx , dcmplx,/ int, ifix, idint, real, float, .... ftype(3F) 

abs: return integer absolute value abs(3C) 

a641, 164a: convert between long integer and base-64 ASCII string .. a641(3C) 

sputl, sgetl : access long integer data in a machine/ sputl(3X) 

atol , atoi: convert string to integer strtol, strtol(3C) 

/ltol3: convert between 3*"byte integers and long integers 13tol(3C) 

between 3-byte integers and long integers 13tol , ltol3: convert .... 13tol(3C) 

bcopy: interactive block copy bcopy(IM) 

system consistency check and interactive repair, /file fsck(IM) 

rjestat: RJE status report and interactive status console rjestat(IC) 

cat: phototypesetter interface cat(7) 

err: error-^-logging interface err (7) 

termio: general terminal interface termio(7) 

tty: controlling terminal interface tty(7) 

characters asa: interpret ASA carriage control .... asa(1) 

sno: SNOBOL interpreter sno(1) 

pipe: create an interprocess channel pipe(2) 

facilities status ipcs: report inter-process communication ipcs(1) 

package stdipc: standard interprocess communication stdipc(3C) 

sleep: suspend execution for an interval sleep(l) 

sleep: suspend execution for interval sleep(3C) 

subroutines and libraries intro: introduction to intro(3) 

miscellaneous facilities intro: introduction to intro(5) 

and application programs intro: introduction to commands ... intro(l) 

formats intro: introduction to file intro(4) 

intro: introduction to games intro(6) 

files intro: introduction to special intro(7) 

maintenance commands and/ intro: introduction to system intro(IM) 

calls and error numbers intro: introduction to system intro(2) 

maintenance procedures intro: introduction to system intro(8) 
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application programs intro: introduction to commands and intro(l) 

intro: introduction to file formats intro(4) 

intro: introduction to games intro(6) 

facilities intro: introduction to miscellaneous intro(5) 

intro: introduction to special files intro(7) 

libraries intro: introduction to subroutines and ... intro(3) 

maintenance commands/ intro: introduction to system intro(IM) 

maintenance procedures intro: introduction to system intro(8) 

error numbers intro: introduction to system calls and intro(2) 

ncheck: generate names from i-^numbers ncheck(IM) 

ioctl; control device ioctl(2) 

abort: generate an lOT fault abort(3C) 

semaphore set or shared memory/ ipcrm: remove a message queue, .... ipcrm(l) 

communication facilities status ipcs: report inter-process ipcs(1) 

/islower, isdigit, isxdigit, isalnum, isspace, ispunct,/ ctype(3tion 

section header of a/ Idshread, Idnshread : read an indexed/named .. ldshread(3X) 

indexed/named section/ Idsseek, Idnsseek: seek to an ldsseek(3X) 

file header of a common object/ Idohseek: seek to the optional .... ldohseek(3X) 

object file for reading Idopen, Idaopen: open a common .... ldopen(3X) 

relocation entries of a section/ Idrseek, Idnrseek: seek to ldrseek(3X) 

indexed/named section header of/ Idshread, Idnshread: read an ldshread(3X) 

indexed/named section of a/ Idsseek, Idnsseek: seek to an ldsseek(3X) 

symbol table entry of a common/ Idtbindex: compute the index of a . ldtbindex(3X) 

table entry of a common object/ Idtbread: read an indexed symbol .. ldtbread(3X) 

table of a common object file Idtbseek: seek to the symbol ldtbseek(3X) 

getopt: get option letter from argument vector getopt(3C) 

lexical tasks lex: generate programs for simple . lex(1) 

lex: generate programs for simple lexical tasks lex(1) 

introduction to subroutines and libraries intro: intro(3) 

ordering relation for an object library lorder: find lorder(l) 

archives ar : archive and library maintainer for portable ... ar(1) 

ulimit: get and set user limits ulimit(2) 

line: read one line lined) 

establish an out-going terminal line connection dial: dial(3C) 

type, modes, speed, and line discipline, /set terminal .... getty(IM) 
object file linenum: line number entries in a common ... linenum(M) 

/Idlinit, Idlitem: manipulate line number entries of a common/ .. ldlread(3X) 

of a/ Idlseek, Idnlseek: seek to line number entries of a section .. ldlseek(3X) 

object/ strip: strip symbol and line number information from an , strip(l) 

nl : line numbering filter nl(1) 

cut out selected fields of each line of a file cut: cut(1) 

Ipd: line printer daemon IpdClC) 

send/cancel requests to an LP line printer Ip, cancel: lp(1) 

Ipr: line printer spooler lpr(1) 

line: read one line lined) 

Isearch: linear search and update lsearch(3C) 

col; filter reverse line-feeds colCl) 

common object file linenum: line number entries in a . linenum(4) 
comm: select or reject lines common to two sorted files ., commd) 

uniq: report repeated lines in a file uniqd) 

of several files or subsequent lines of one file /same lines pasted) 

subsequent/ paste: merge same lines of several files or pasted) 
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link, unlink: exercise link and unlink system calls link(IM) 

files Id: link editor for common object ld(i) 

a. out: common assembler and link editor output a.out(4) 

link: link to a file link(2) 

cp, In, mv : copy, link or move files cp(1) 

link: link to a file link(2) 

and unlink system calls. link, unlink: exercise link link(IM) 

lint: a C program checker lint(l) 

nlist: get entries from name list nlist(3C) 

Is: list contents of directories ls(1) 

for a file system, ff: list file names and statistics .... ff(1M) 

nm: print name list of common object file nm(1) 

fsck checklist: list of file systems processed by . checklist(4) 

associated with a/ sparelist: list the spared sectors ........... sparelist(8) 

xargs: construct argument list(s) and execute command xargs(l) 

cp. In, mv: copy, link or move files .. cp(1) 

tzset: convert date and/ ctime, localtime, gmtime, asctime, ctime(3C) 

end, etext, edata: last locations in program end(3C) 

memory plock: lock process, text, or data in .... plock(2) 

gamma: log gamma function gamma(3M) 

newgrp: log in to a new group newgrp(l) 

exponential, logarithm,/ exp, log, loglO, pow, sqrt: exp(3M) 

logarithjB, power,/ exp, log, loglO, pow, sqrt: exponential, .... exp(3M) 

/logic, pow, sqrt: exponential, logarithm, power, square root/ .... exp(3M) 

errpt: process a report of logged errors. errpt(IM) 

getlogin: get login name getlogin(3C) 

logname: get login name logname(l) 

cuserid: get character login name of the user cuserid(3S) 

logname: return login name of user logname(3X) 

passwd: change login password passwd(l) 

login: sign on logind) 

setting up an environment at login time profile: profile(4) 

logname: get login name logname(l) 

user logname: return login name of logname(3X) 

a641, 16Ma: convert between long integer and base-64 ASCII/ ... a641(3C) 

independent/ sputl , sgetl: access long integer data in a machine .... sputl(3X) 

between 3-byte integers and long integers /ltol3: convert 13tol(3C) 

setjmp, longjmp: non-local goto setjmp(3C) 

for an object library lorder: find ordering relation .... lorder(l) 

nice: run a command at low priority nice(1) 

to an LP line printer Ip, cancel: send/cancel requests .. lp(1) 

send/cancel requests to an LP line printer Ip, cancel: lp(1) 

enable, disable: enable/disable LP printers enable(l) 

/Ipshut, Ipraove: start/ stop the LP request scheduler and move/ .... Ipsched(IM) 

accept, reject: allow/ prevent LP requests accept(IM) 

Ipadmin: configure the LP spooling system Ipadmin(IM) 

Ipstat: print LP status information Ipstat(l) 

spooling system. Ipadmin: configure the LP Ipadmin(IM) 

Ipd: line printer daemon Ipd(IC) 

request/ Ipsched , Ipshut, Ipmove: start/ stop the LP Ipsched(IM) 

Ipr: line printer spooler lpr(1) 

start/ stop the LP request/ Ipsched, Ipshut, Ipmove: Ipsched(IM) 
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LP request scheduler/ Ipsched , Ipshut, Ipraove: start/ stop the Ipsched(IM) 

information Ipstat; print LP status Ipstat(l) 

jrandi|8,/ drand48, erand48, lrand48, nrand48, mrand48, drand48(3C) 

Is: list contents of directories .. ls(1) 

update Isearch: linear search and lsearch(3C) 

pointer Iseek: move read/write file lseek(2) 

integers and long/ 13tol , ltol3: convert between S’-byte 13 tol( 3 C) 

m4: macro processor m4(1) 

fscv: convert files between M68000 and VAX-^1 1/780/ fscv(IM) 

your processor/ pdpll, u3b, vax, m68k: provide truth value about ... machid(l) 

/access long integer data in a machine independent fashion sputl(3X) 

documents mm: the MM macro package for formatting mm (5) 

mosd : the OSDD adapter macro package for formatting/ raosd(5) 

permuted index mptx: the macro package for formatting a .... mptx(5) 

viewgraphs and/ mv : a troff macro package for typesetting mv(5) 

m4: macro processor m4(1) 

documents formatted with the MM macros /checkmm: print/check mm(1) 

this manual man: macros for formatting entries in .. man(5) 

rmail: send mail to users or read mail mail, mail(l) 

or read mail mail, rmail: send mail to users ... raail(l) 

mail, rmail: send mail to users or read mail mail(l) 

malloc, free, realloc, calloc: main memory allocator malloc(3C) 

groups of programs make: maintain, update, and regenerate .. make(1) 

ar : archive and library maintainer for portable archives .. ar(1) 

intro: introduction to system maintenance commands and/ intro(IM) 

intro: introduction to system maintenance procedures introC8) 

mkdir: make a directory mkdird) 

ordinary file mknod : make a directory, or a special or . mknod(2) 

mkterap: make a unique filename mktemp(3C) 

regenerate groups of programs make: maintain, update, and raake(l) 

banner: make posters banner (1) 

makekey: generate encryption key .. makekey(l) 
main memory allocator malloc, free, realloc, calloc: .... malloc(3C) 

entries in this manual man: macros for formatting man(5) 

onyx: Onyx 6810 special system service .. onyx (2) 

service onyx: Onyx 6810 special system .... onyx (2) 

one spare: replace a bad sector with a spare . spareCB) 

spare: replace a bad sector with a spare one spare(8) 

sparelist: list the spared sectors associated with a slice ... sparelist(8) 

onyx: Onyx 6810 special system service onyx(2) 

spared sectors associated with a slice sparelist: list the sparelist (8) 

replace a bad sector with a spare one spare: spare(6) 

a spare one spare: replace a bad sector with .. spare(8) 

slice sparelist: list the spared sectors associated with a .. sparelist (8) 

sectors associated with a slice sparelist: list the spared sparelist (8) 

onyx: Onyx 6810 special system service onyx(2) 

adduser: add a user to the system adduser(IM) 

onyx: Onyx 6810 special system service onyx (23 

checkcw: prepare constant^width text for troff cw, cw(1) 

plock: lock process, text, or data in memory plock(2) 

tgetstr, tgoto, tputs: terminal/ tgetent, tgetnum, tgetflag, termcap(3) 

terminal/ tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: .. termcap(3) 
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tgoto, tputs: terminal/ tgetent, tgetnum, tgetflag, tgetstr, termcap(3) 

tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: terminal/ .. termcap(3) 

tgetnum, tgetflag, tgetstr, tgoto, tputs: terminal/ tgetent, termcap(3) 

ttt, cubic; tic^tac-'toe ttt(6) 

stime: set time stime(2) 

time: get time time(2) 

time: time a command timed) 

data and system activity tiraex : time a command; report process .... timexCl) 

systems for optimal access time, dcopy: copy file dcopyClM) 

time: get time time(2) 

profil: execution time profile profil(2) 

up an environment at login time profile: setting profile(4) 

time: time a command timed) 

asctime, tzset: convert date and time to string /gmtime, ctime(3C) 

clock: report CPU time used clock(3C) 

process times times: get process and child times(2) 

update access and modification times of a file touch: touchCl ) 

get process and child process times times: times(2) 

set file access and modification times utime: utime(2) 

process data and system/ timex : time a command; report timexCl) 

tmpfile; create a temporary file .. tmpfile(3S) 
for a temporary file tmpnam, tempnam: create a name .... tmpnam(3S} 

/tolower, ^toupper, __tolower , toascii: translate characters conv(3C) 

popen, pclose: initiate pipe to/from a process popen(3S) 

toupper, tolower, _to upper , __tolower, toascii; translate/ conv(3C) 

toascii: translate/ toupper, tolower, _^toupper, __tolower, conv(3C) 

tsort: topological sort tsortCl ) 

acctmerg: merge or add total accounting files acctmergClM) 

modification times of a file touch: update access and touch(l) 

translate/ toupper, tolower, __^to upper , __tolower, toascii: conv(3C) 

^tolower, toascii: translate/ toupper , tolower , __toupper, conv(3C) 

/tgetflag, tgetstr, tgoto, tputs: terminal independent/ termcap(3) 

tr: translate characters trCl) 

ptrace: process trace ptrace(2) 

trace: event^tracing driver trace(7) 

tr: translate characters trCl) 

_^toupper, _^tolower , toascii: translate characters /tolower, .... conv(3C) 

ftw: walk a file tree ftw(3C) 

twalk: manage binary search trees tsearch, tdelete, tsearch(3C) 

tan, asin, acos, atan, atan2: trigonometric functions /cos, trig(3M) 

tbl : format tables for nroff or troff tblCl) 

prepare constant^width text for troff cw, checkcw: cwCl ) 

typesetting viewgraphs and/ mv: a troff macro package for mv(5) 

mathematical text for nroff or troff /neqn, checkeq; format eqnCl) 

troff; typeset text troffd) 

values true, false: provide truth trued ) 

pdpll, u3b, vax, m68k: provide truth value about your processor/ . machidd) 

true, false: provide truth values trued) 

binary search trees tsearch, tdelete, twalk: manage ... tsearch(3C) 

tsort: topological sort tsortd) 

ttt, cubic: tic-r-tac-toe ttt (6) 

interface tty: controlling terminal tty(7) 
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tty: get the terminal’s name tty(1) 

greek: graphics for the extended TTY*-37 type-box greek(5) 

terminal ttyname, isatty; find name of a ... ttyname(3C) 

utmp file of the current user ttyslot: find the slot in the ttyslot(3C) 

/runacct, shutacct, startup, turnacct: shell procedures for/ ... acctsh(IM) 

trees tsearch, tdelete, twalk: manage binary search tsearch(3C) 

file: determine file type filed ) 

getty: set terminal type, modes, speed, and line/ getty(IM) 

truth value about your processor type /u3b, vax, m68k: provide . machid(l) 

graphics for the extended TTY-37 type-box greek: greek(5) 

types: primitive system data types types(5) 

types types: primitive system data types(5) 

and slides mmt, mvt: typeset documents, viewgraphs, .... mmt(1) 

troff: typeset text troff(l) 

mv: a troff macro package for typesetting viewgraphs and/ mv(5) 

/localtime, gmtime, asctime, tzset: convert date and time to/ .. ctime(3C) 

value about your/ pdpll, u3b, vax, m68k: provide truth machid(l) 

getpw: get name from UID getpw(3C) 

ulimit: get and set user limits ... ulimit(2) 
mask umask: set and get file creation .. umask(2) 

mask umask: set file-creation mode ..... umaskd ) 

file system, mount, umount: mount and dismount mount(IM) 

umount: unmount a file system umount(2) 

operating system uname: get name of current uname(2) 

System uname: print name of current UNIX . uname(l) 
input stream ungetc: push character back into ,. ungetc(3S) 

seed48, lcong48: generate uniformly distributed/ /srand48, .. drand48(3C) 

file uniq: report repeated lines in a ,, uniq(l) 

mktemp: make a unique filename mktemp(3C) 

units: conversion program units(l) 

config: configure UNIX SYSTEM V config.68dM) 

cu: call another UNIX SYSTEM V system cuClC) 

unlink system calls, link, unlink: exercise link and linkClM) 

unlink: remove directory entry .... unlink(2) 

unlink: exercise link and unlink system calls, link, link(IM) 

umount: unmount a file system uraount(2) 

files pack, peat, unpack: compress and expand pack(1) 

Isearch: linear search and update lsearch(3C) 

times of a file touch: update access and modification .... touch(l) 

programs make: maintain, update, and regenerate groups of .. make(1) 

sync: update super-block sync (2) 

sync: update the super block sync(1) 

du: summarize disk usage du(1) 

lognarne: return login name of user logname(3X) 

su: become superuser or another user su(1) 

write: write to another user write(l) 

setuid, setgid: set user and group IDs setuid(2) 

id: print user and group IDs and names id(1) 

get character login name of the user cuserid: cuserid(3S) 

and/ /getgid, getegid : get real user, effective user, real group, . getuid(2) 

environ: user environment environ(5) 

ulimit: get and set user limits ulimit(2) 
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/getegid : get real user, effective user, real group, and effective/ ,, getuid(2) 

adduser: add a user to the system adduser(IM) 

in the utmp file of the current user ttyslot: find the slot ttyslot(3C) 

wall: write to all users wall(IM) 

editor (variant of ex for casual users) edit; text edit(1) 

mail, rmail; send mail to users or read mail raail(l) 

statistics ustat: get file system ustat(2) 

modification times utime: set file access and utime(2) 

utmp, wtmp: utmp and wtmp entry formats utmp(4) 

endutent, utmpname: access utmp file entry /setutent, getut(3C) 

ttyslot; find the slot in the utmp file of the current user ttyslot(3C) 

formats utmp, wtmp; utmp and wtmp entry ... utmp(4) 
/pututline, setutent, endutent, utmpname; access utmp file entry .. getut(3C) 

clean-up. uuclean; uucp spool directory uuclean(IM) 

uusub; monitor uucp network uusub(IM) 

uuclean: uucp spool directory clean-up uuclean(IM) 

control uustat; uucp status inquiry and job uustat(IC) 

copy uucp, uulog, uuname; unix to unix . uucp(IC) 

uucp, uulog, uuname; unix to unix copy uucp(IC) 

uucp, uulog, uuname; unix to unix copy uucp(IC) 

System- to-UN IX System file/ uuto, uupick: public UNIX uuto(IC) 

job control uustat; uucp status inquiry and ... uustat(IC) 

uusub; monitor uucp network uusub(IM) 

System-to-UNIX System file copy uuto, uupick; public UNIX uuto(IC) 

execution uux ; unix to unix command uux(IC) 

abs; return integer absolute value abs(3C) 

/u3b, vax, m68k; provide truth value about your processor type ... machid(l) 

getenv; return value for environment name getenv(3C) 

ceiling, remainder, absolute value functions /fabs; floor, floor(3M) 

true, false; provide truth values trued ) 

edit; text editor (variant of ex for casual users) .. edit(1) 

about your processor/ pdpll, u3b, vax, m68k; provide truth value .... machid(l) 

/files between M68000 and VAX-11 /780 processors fscv(IM) 

vc; version control vc(1) 

get option letter from argument vector getopt; getopt(3C) 

assert; verify program assertion assert(3X) 

vpr; Versa tec printer spooler vpr(1) 

vc; version control vc(1) 

display editor based on ex vi; screen oriented (visual) vi(1) 

mmt, mvt: typeset documents, viewgraphs, and slides mmt(1) 

macro package for typesetting viewgraphs and slides /a troff mv(5) 

ex vi; screen oriented (visual) display editor based on .. vi(1) 

systems with label checking. volcopy, labelit; copy file volcopy(IM) 

systems with label checking. volcopy, labelit; copy file volcopy . 1m, old 

file system; format of system volume fs(4) 

vpr; Versatec printer spooler vpr(1) 

process wait; await completion of wait(1) 

terminate wait; wait for child process to stop or . wait(2) 

stop or terminate wait: wait for child process to ... wait(2) 

ftw: walk a file tree ftw(3C) 

wall: write to all users walKiM) 

wc: word count wc(1) 

- xxvi - 



Permuted Index 


signal signal: specify what to do upon receipt of a signal(2) 

signal signal: specify what to do upon receipt of a signal. 2. old 

crashes crash: what to do when the system crash.m68(8) 

whodo: who is doing what whodo(IM) 

who: who is on the system who(l) 

who: who is on the system who(1) 

whodo: who is doing what, whodo(IM) 

cd : change working directory cd(1) 

chdir: change working directory chdir(2) 

getcwd : get pathname of current working directory getcwd(3C) 

pwd : working directory name pwd(1) 

write: write on a file write(2) 

putpwent: write password file entry putpwent(3C) 

wall: write to all users walKiM) 

write: write to another user write(l) 

write: write on a file write (2) 

write: write to another user write(1) 

open: open for reading or writing open(2) 

utmp, wtmp: utmp and wtmp entry formats utrap(4) 

formats utmp, wtmp: utmp and wtmp entry utmp(M) 

accounting records, fwtmp, wtmpfix: manipulate connect fwtrap(IM) 

hunt-the-wumpus wump: the game of wump(6) 

and execute command xargs: construct argument list(s) . xargs(l) 

jOf j1. jn, yO, y1, yn: Bessel functions bessel(3M) 

JO, j1, jn, yO, y1, yn: Bessel functions bessel(3M) 

compiler-compiler yacc: yet another yacc(l) 

JO, j1, jn, yO, y1, yn: Bessel functions bessel(3M) 
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